代理线束构造

文档 社区

技能解读

当前原文的自动摘译,尚未人工审校。

核心模型

智能体输出质量受限于: 行动空间质量 观察质量 恢复质量 上下文预算质量

行动空间设计

使用稳定、明确的工具名称。 保持输入模式优先且范围狭窄。 返回确定性的输出形状。 除非无法隔离,否则避免使用全能型工具。

粒度规则

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

观察设计

每个工具响应都应包括: status: success|warning|error summary: 一行结果 next_actions: 可执行的后续步骤 artifacts: 文件路径 / ID

错误恢复契约

对于每个错误路径,应包括: 根本原因提示 安全重试指令 明确的停止条件

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@affaan-m · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# 智能体框架构建

当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时,使用此技能。

## 核心模型

智能体输出质量受限于:

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
* 每个成功任务的成本

## 反模式

* 太多语义重叠的工具。
* 不透明的工具输出,没有恢复提示。
* 仅输出错误而没有后续步骤。
* 上下文过载,包含不相关的引用。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。