Agent 教程

外观

第 3 章合同：Tool 系统 ​

章节目标 ​

读者理解模型为什么需要工具、工具如何注册、如何描述 schema、如何把结果返回模型。

必须覆盖的源码 ​

  • restored-src/src/Tool.ts
  • restored-src/src/tools.ts
  • restored-src/src/services/tools/toolExecution.ts
  • restored-src/src/services/tools/toolOrchestration.ts
  • restored-src/src/tools/FileReadTool/FileReadTool.ts
  • restored-src/src/tools/FileEditTool/FileEditTool.ts
  • restored-src/src/tools/BashTool/BashTool.tsx

必须回答的问题 ​

  • Tool 接口包含哪些关键能力？
  • 工具列表如何生成？
  • 工具 schema 为什么重要？
  • 工具结果如何变成模型能理解的 tool_result？
  • 什么样的工具可以并发？

必须包含的迁移观点 ​

自研 Agent 应先实现小而稳定的 Tool 抽象，再加权限、UI 渲染和插件化。

验收标准 ​

  • 给出 Tool 生命周期。
  • 给出简化版 Tool 接口。
  • 至少用 FileRead 或 Bash 做一个案例。