跳转到内容

Agent Tool Design Checklist(智能体工具设计检查清单)

知识库位置:FDE Knowledge Base/03 Engineering/Checklists/Agent-Tool-Design-Checklist.md

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