103、【Agent】【OpenCode】task 工具提示词（参数内容）

【声明】本博客所有内容均为个人业余时间创作所述技术案例均来自公开开源项目如GithubApache基金会不涉及任何企业机密或未公开技术如有侵权请联系删除背景上篇 blog【Agent】【OpenCode】task 工具提示词examples分析了 Task 提示词中举的例子首先定义了两个虚拟的子智能体专家code-reviewer负责代码审查和greeting-responder负责问候然后用户提出了需求这里主 Agent 并没有一上来就用 Task 把任务分配给子 Agent而是直接调用 Write 工具把代码写出来在真正调用code-reviewer之前系统插入了一段commentary内心独白紧接着主 Agent 开始启动code-reviewer进行主动质检在大模型里写代码的模型Writer和代码审查的模型Reviewer往往需要不同的思维写代码需要创造力和逻辑连贯性而审查代码则需要批判性思维和找茬能力最后是任务派发主 Agent 不需要知道code-reviewer内部是怎么检查代码的只需要做简单标准的派发动作体现了多智能体协作的松耦合设计下面继续分析OpenCode接着看另一个例子greeting-responder当用户打招呼时主 Agent 会调用greeting-responder进行回应这里专门搞一个greeting-responder可以进行人设隔离因为主 Agent 平时要处理复杂的代码逻辑必须保持严谨理性所以如果让它强行讲笑话可能会显得很尴尬所以这种陪聊的场景就可以交给一个专门调教过性格活泼的子 AgentOK下面看 Task 工具的参数内容description任务简述必选项一个简短的约 3 ~ 5 个单词的任务描述有人可能会觉得这个字段有点多余因为下面还有一个详细的prompt字段但实际上这个字段是为了人机交互体验设计的是给人类用户看的 UI 标签当后台同时跑着五六个子 Agent 时前端界面不可能把几百字的prompt全展示出来而这个description字段能让用户一眼就能在进度条或日志里看清楚当前子 Agent 正在后台执行什么任务prompt详细指令必选项这里定义了子 Agent 需要执行的具体任务内容是给 AI 看的完整剧本这是整个调用的关键字段之前 blog 强调过子 Agent 默认是黑盒的因此这里的prompt内容必须是高度自包含Self-contained的独立工单主 Agent 不能只是简单写个【去查一下】提示词而是要把背景信息具体目标输出格式甚至禁忌事项全部写清楚因为子智能体一旦启动就只能看到这份剧本subagent_type专家类型必选项指定要使用的特定类型的专业智能体就是多智能体架构中的路由机制主 Agent 作为总指挥其掌握着各种 Agent 的花名册比如code-reviewerbash-expertdocumentation-writer通过这个字段参数主 Agent 能够精准地把任务分发给拥有对应工具权限和系统提示词的子智能体不仅能保证专业性也能保证安全隔离比如只给某些子智能体开放读文件的权限而不给写入权限task_id会话锚点可选项当想要恢复之前的任务时设置传入之前的task_id可以让任务在同一个子智能体会话中继续而不是开启全新的会话默认情况下子智能体的会话是一次性的但带上了task_id可以让子智能体接着之前的进度继续干活这对处理超长多轮次的复杂开发任务很有帮助避免重复传输海量背景信息浪费 Tokencommand触发源可选项触发此任务的原始命令是个用来审计与调试的字段在复杂的自动化工作流中一个子智能体的启动可能源于用户输入的斜杠命令也可能源于主 Agent 内部的一次自动触发通过传入这个触发源相当于给这次的任务派发打了个来源标签后面当系统出现 Bug 或需要复盘时开发者可以清晰的追踪到命令来源方便定位OK本篇先到这里如有疑问欢迎评论区留言讨论祝各位功力大涨技术更上一层楼更多内容见下篇 blog【Agent】【OpenCode】webfetch 工具提示词