Agent-接驳件构建

Agent-接驳件构建 是做什么的？

当您要改进Agent的规划、工具调用、错误恢复以及收敛完成时，请使用此技能。

核心模型

Agent输出质量受以下因素制约：

1. 动作空间质量
2. 观察质量
3. 恢复质量
4. 上下文预算质量

动作空间设计

1. 使用稳定、显式的工具名称。
2. 保持输入以schema优先且范围狭窄。
3. 返回确定性的输出形状。
4. 除非无法隔离，否则避免使用全能型工具。

粒度规则

• 对高风险操作（部署、迁移、权限）使用微工具。
• 对常见的编辑/读取/搜索循环使用中等工具。
• 仅当往返开销是主要成本时，才使用宏工具。

观察设计

每个工具响应应包含：

• status: success|warning|error
• summary: 一行摘要
• next_actions: 可操作的后续步骤
• artifacts: 文件路径 / 唯一标识符

错误恢复合约

对于每条错误路径，包含：

• 根因提示
• 安全重试指令
• 显式终止条件

上下文预算规划

1. 保持系统提示简洁且不变。
2. 将大量指导性内容移至按需加载的技能中。
3. 优先引用文件，而非内联长文档。
4. 在阶段边界处进行压缩，而不是在任意token阈值处。

架构模式指南

• ReAct：最适合探索性任务，路径不确定。
• 函数调用：最适合结构化确定性流程。
• 混合模式（推荐）：ReAct规划 + 类型化工具执行。

基准测试

跟踪：

• 完成率
• 每次任务的重试次数
• pass@1 和 pass@3
• 每次成功任务的成本

反模式

• 工具太多且语义重叠。
• 工具输出不透明且没有恢复提示。
• 只输出错误而没有后续步骤。
• 上下文过载，塞入无关的引用。