智能体框架构建¶

当需要改进智能体的规划、工具调用、从错误中恢复以及向完成收敛时，使用此技能。

核心模型¶

智能体的输出质量受以下因素制约： 1. 动作空间的质量 2. 观测的质量 3. 恢复的质量 4. 上下文预算的质量

动作空间设计¶

1. 使用稳定的显式工具名称。
2. 采用输入模式优先并进行收窄。
3. 返回确定性的输出形状。
4. 除非无法分离，否则避免使用兜底工具。

粒度规则¶

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

观测设计¶

所有工具响应应包含以下内容： - status: success|warning|error - summary: 一行结果 - next_actions: 可执行的后续操作 - artifacts: 文件路径 / ID

错误恢复契约¶

所有错误路径应包含以下内容： - 根本原因提示 - 安全重试指示 - 明确的停止条件

上下文预算管理¶

1. 保持系统提示最小且不可变。
2. 将大型指南迁移到按需加载的技能中。
3. 优先使用对文件的引用，而不是内联插入长文档。
4. 在阶段边界处进行压缩，而不是在任意令牌阈值处。

架构模式指南¶

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

基准测试¶

应跟踪的指标： - 完成率 - 每个任务的重试次数 - pass@1 以及 pass@3 - 每个成功任务的成本

反模式¶

• 语义重叠的工具过多。
• 没有恢复提示的不透明工具输出。
• 只有错误而没有下一步的输出。
• 用无关引用使上下文过载。