人工智能进阶文档深度页
工具调用
模型提出结构化工具调用，应用负责验证、授权、执行并返回结果。
学习目标
- 能说明工具调用解决什么问题，以及何时适用。
- 能解释为什么“把 Schema 当授权”是误区。
学习前需要掌握
背景与问题
模型本身不能因为输出了一段 JSON 就自动拥有文件、网络或业务系统权限。
概念定义
工具调用是一种控制循环：模型依据工具描述生成名称与参数，宿主应用执行真实函数，再把结果返回模型。
直观理解
模型填写申请单，应用检查申请、执行操作并给回执；申请单不是操作本身。
核心原理
模型选择工具与参数，应用保留最终执行权。
Schema 约束形状，业务验证约束语义和权限。
工具结果要有成功、失败和可重试状态，避免自然语言猜测。
理解与实践步骤
- 1
向模型暴露最小工具描述
- 2
接收名称与参数
- 3
验证 Schema 和业务权限
- 4
必要时请求审批
- 5
执行并记录幂等键
- 6
返回结构化结果
- 7
由 Agent 使用结果继续
实际应用
- 读取文件
- 查询数据
- 受控业务操作
常见错误
把 Schema 当授权
无幂等性地重试写操作
把错误字符串当成功结果
本地交互演示
Tool 调用 · 参数、审批与结果
切换工具会改变 Schema、权限流程与实际演示结果。
工具描述
读取允许目录中的 Markdown，纯只读。参数 Schema
{ path: string, max_chars: integer | null }输入参数
{ path: "notes/agent.md", max_chars: 2000 }结果
等待执行…模型可以提出调用，但 Schema 校验由宿主执行。
输入、输出与执行边界
输入
- 工具名
- 参数对象
- 调用者与授权上下文
输出
- 结构化结果
- 错误分类
- 审计记录
能力
- 读取文件
- 查询数据
- 受控业务操作
可能产生写入敏感动作需要审批
官方来源与时效
资料记录日期：2026-08-30（不代表已逐项核验）。产品能力、SDK 参数和协议状态可能变化，请以链接页面的当前版本为准。
推荐学习资料
官方文档A 级
OpenAI Tools Guide
说明模型如何调用函数、搜索、计算机操作及其他工具，并展示结构化参数。
OpenAI · OpenAI Platform