Agent Tool Design Checklist(智能体工具设计检查清单)
知识库位置:
FDE Knowledge Base/03 Engineering/Checklists/Agent-Tool-Design-Checklist.md
Tool Scope(工具范围)
Section titled “Tool Scope(工具范围)”- 每个 Tool(工具)功能单一
- Tool Name(工具名)清晰
- Tool Description(工具描述)明确
- 参数尽量少且确定
Parameters(参数)
Section titled “Parameters(参数)”- 使用明确 Schema(结构定义)
- Enum(枚举取值)已限制
- Required / Optional(必填/可选)已定义
- 参数有 Runtime Validation(运行时校验)
Permission(权限)
Section titled “Permission(权限)”- Tool 本身有权限边界
- 权限绑定当前用户
- 不使用默认 Admin Credential(管理员凭证)
Risk(风险)
Section titled “Risk(风险)”- Read / Write Tool(读/写工具)已区分
- Delete / Transfer / Payment(删除/转账/支付)等高风险操作有确认
- 高风险操作具备审批机制
Reliability(可靠性)
Section titled “Reliability(可靠性)”- Tool Timeout(工具超时)已设置
- Error(错误)返回结构稳定
- Retry(重试)行为明确
- Tool Result(工具结果)可供模型理解
Audit(审计)
Section titled “Audit(审计)”- Tool Name(工具名)被记录
- Input(输入)被记录或安全摘要
- Output(输出)有必要记录
- User Identity(用户身份)可关联
- 时间和结果可追踪
Recommended Pattern(推荐模式)
Section titled “Recommended Pattern(推荐模式)”LLM(大语言模型)↓Tool Request(工具请求)↓Policy Check(策略检查)↓Parameter Validation(参数校验)↓Human Confirmation if Needed(必要时人工确认)↓Execution(执行)↓Audit(审计)↓Result(结果)