用途:操作 Harbor 的 harbor exec 命令,将零散输入编译为 Harbor 任务,在其上运行 Harbor 作业,并可选地聚合结果,整体类似智能体化的 map-reduce。
前置检查:假定用户已安装 Harbor CLI,先确认命令面:harbor --version 与 harbor exec --help。harbor exec 需要 Harbor >=0.17.1,版本过低应先升级。调试配置解析、推断产物、任务/作业目录或默认值时可用 --print-config,但它不能替代展示最终启动命令。若 harbor 命令不可用,先询问用户安装方式,不要猜测命令路径。
运行前需与用户确认未指定的参数:输入的确切路径/glob 以及是否使用 --scan 或 --no-scan;产物契约(智能体必须写入的输出文件路径);每个产物所需的 JSON 或结构化 schema;环境提供方(建议云沙箱而非本地 docker,可考虑 modal、daytona 或 e2b);map 步骤的智能体与模型;并发数;是否包含 reduce 步骤及所用 reduce 智能体与模型;最后在运行前展示确切的启动命令。
使用方式:一次性运行优先用标志,可重复或 map-reduce 工作流用 --config。当正确性依赖生成文件时显式声明产物,例如:harbor exec -p ./input -i "Write /app/answer.json" -f /app/answer.json。优先显式产物而非自动推断,自动推断只读取内联指令,不读取指令文件。默认不持久化编译任务,除非用户想检查或复用,否则省略 --tasks-dir,此时编译任务为临时并在执行后清理。默认不设置作业输出位置,仅在需要指定输出路径时用 --jobs-dir,默认是 jobs。任务基数重要时明确指定 --scan 或 --no-scan;当前标志模式下默认扫描单个目录或 glob,但多路径会被分组,除非显式 --scan。不要将 --config 与标志模式选项混用,应在文件中构建完整 ExecConfig。
Map 与 Reduce:map.compile 定义任务合成(指令、复制路径、Docker 镜像/工作目录、产物、模板、编译期验证器生成);map.job 定义执行(智能体、模型、环境提供方、重试、尝试次数、并发、指标、作业目录)。Reduce 阶段需要 map.compile.artifacts,reducer 消费暂存于 environment/artifacts 的先前 map 试验产物,只编译一个 reducer 任务,除非 reducer 专用标志/配置覆盖,否则继承 map 作业设置,通常应显式定义 reducer 产物并验证。编写具体命令、配置文件或 map-reduce 示例时可参考 references/examples.md。
限制:资料未提供更多关于收费、平台支持或具体效果的信息。