SuperAPI AI 工具集

mesh

智能体与模型

查看项目

更新于 10-16 04:22

技能介绍

用途:$mesh 是 Codex 面向已完成规划、形状统一的叶子任务的高扇出批处理执行路径。它执行的是已经成型的行式工作,不负责规划或分解。

主要能力:映射到 spawn_agents_on_csv,而非独立运行时协议。批任务为 CSV 每一行启动一个工作子智能体;主调用阻塞直到批次结束;每个 worker 必须恰好调用一次 report_agent_job_result;结果导出到 output_csv_path 或默认输出 CSV。

使用条件:用户明确要求 $mesh,或重复叶子工作已明显呈行状;工作负载行状且同质;每行可独立处理;每行代表一个带有唯一范围与验收目标的实质单元;需要按行导出结构化结果到 CSV;规划已完成,只剩叶子执行。

不适用:研究、评审、辩论或设计类工作;仍需分解或共享判断的任务;任务共享上下文或相互依赖;多个 worker 会触及同一可变范围;直接 spawn_agent 委派或本地执行更清晰时。

推荐用法:每行审计一个文件;每行分类一张工单、一段日志或一份文档;从大量输入提取结构化字段;对文件列表运行同一有界转换且输出互不相交;在 $select 或 $teams 已成型后,每行执行一个互不相交的实现单元。异质工作应改用 $teams 或直接 spawn_agent。

行设计规则:每行目标具体且有界,一行一个实质单元、唯一范围与验收目标;write_scope 与 lock-roots 契约对齐;优先只读或互不相交的写范围;结果对象结构化且可跨行比较;需要后续对账时使用稳定行 id;不要仅因角色或通道而复制行,除非有阻塞或验证失败作为依据。

结果契约:每个 worker 通过 report_agent_job_result 恰好上报一次 JSON 结果,缺失即失败;叙述性文本非权威,结构化结果才有效;output_schema 应最小化且与实际需要字段一致。

反模式:把 $mesh 当 $teams 的通用替代;在批 worker 内做递归规划或辩论;把紧耦合实现拆成相互依赖的行;行间写范围重叠;实质工作完成后又发起合成证据波次;无阻塞依据地复制 coder/fixer/prover/integrator 行;走已弃用 shim;依赖自由文本而非结构化字段;csv_path 与 output_csv_path 使用同一路径。

实际运行后,最终响应可用散文给出简短 Orchestration Ledger(所用技能、子智能体、产出物、清理状态);未发生编排则省略。$teams 交接给 $mesh 时应包含:规划已完成且只剩叶子执行的确认、CSV 或行模式、指令模板、预期输出字段、并发或超时假设。

限制:以上细节来自公开资料,具体运行时行为、平台支持与配置默认值以实际环境为准,资料未提供的内容暂未提供。