人工智能进阶文档深度页
Tools：能力、Schema 与执行边界
Tool 把读取、计算或行动封装成有名称、输入、输出、权限和错误契约的能力。
学习目标
- 能说明Tools：能力、Schema 与执行边界解决什么问题，以及何时适用。
- 能解释为什么“自然语言描述代替 Schema”是误区。
学习前需要掌握
背景与问题
模型训练参数无法自动访问最新数据或真实系统；工具连接外部能力，同时引入权限、副作用和失败处理。
概念定义
Tool 是 Agent 可以请求调用、由宿主或服务执行的具体能力。它可以是内置工具、函数工具、API、本地文件/搜索/代码/计算工具，或另一个 Agent。
直观理解
Skill 是操作手册，Tool 是真正完成动作的仪器；说明书不会自己钻孔，电钻也不会决定项目流程。
核心原理
完整工具契约包含名称、描述、输入 Schema、输出 Schema、错误、权限、超时和副作用。
调用过程为选择—参数生成—验证—审批—执行—结果验证—反馈。
重试必须区分只读、幂等写入与非幂等副作用。
日志记录调用 id、工具版本、参数摘要、审批、耗时和结果状态。
理解与实践步骤
- 1
定义单一职责工具
- 2
编写输入输出 Schema
- 3
标记只读或写入与权限
- 4
执行前验证和审批
- 5
设置超时与有限重试
- 6
返回结构化成功或错误
- 7
验证结果并记录日志
实际应用
- 内置搜索
- 函数与 API
- 本地文件
- 代码与数学计算
- Agent as Tool
常见错误
自然语言描述代替 Schema
错误没有分类
写操作无审批和幂等性
工具结果未经验证
本地交互演示
Tool 调用 · 参数、审批与结果
切换工具会改变 Schema、权限流程与实际演示结果。
工具描述
读取允许目录中的 Markdown，纯只读。参数 Schema
{ path: string, max_chars: integer | null }输入参数
{ path: "notes/agent.md", max_chars: 2000 }结果
等待执行…模型可以提出调用，但 Schema 校验由宿主执行。
输入、输出与执行边界
输入
- 工具名
- 结构化参数
- 授权与调用上下文
输出
- 结构化数据
- 副作用确认
- 可分类错误
能力
- 内置搜索
- 函数与 API
- 本地文件
- 代码与数学计算
- Agent as Tool
权限
- 每次调用按身份与资源重新授权
- 敏感或写入操作默认审批
可能产生写入敏感动作需要审批
官方来源与时效
资料记录日期：2026-08-30（不代表已逐项核验）。产品能力、SDK 参数和协议状态可能变化，请以链接页面的当前版本为准。
推荐学习资料
官方文档A 级
OpenAI Agents SDK 文档
系统介绍 Agent、工具、Handoff、Guardrail、Session 与追踪等核心组件。
OpenAI · OpenAI
资料笔记
官方文档A 级
OpenAI Tools Guide
说明模型如何调用函数、搜索、计算机操作及其他工具，并展示结构化参数。
OpenAI · OpenAI Platform
资料笔记
GitHub 仓库A 级
openai/openai-agents-python
OpenAI Agents SDK 的 Python 源码、文档、示例与集成测试仓库。
OpenAI · GitHub
仓库信息
构建和研究多 Agent 工作流
主要语言：Python包含数据集或实验需要额外环境