第六部分,OpenAI SDK 与 API
函数调用与结构化输出
用 JSON Schema 定义工具和输出,建立参数验证、执行审批和结果回传闭环。
函数调用把意图变成参数
函数调用让模型选择应用提供的工具并生成结构化参数。模型不会替你执行函数,应用必须校验参数、检查权限、运行代码,再把结果返回给模型。
工具描述要清楚说明用途和限制,schema 尽量收窄。不要用一个包含任意命令或任意 URL 的万能工具。
- 定义工具名称、说明和 JSON Schema。
- 把工具随请求提供给模型。
- 解析工具调用并验证参数。
- 执行权限和业务规则检查。
- 运行工具并返回结构化结果。
- 继续响应直到得到最终答案。
结构化输出约束最终数据
当下游代码需要稳定字段时使用结构化输出。Python 可以从 Pydantic 模型生成 schema,JavaScript 可以配合 Zod。即使结构校验通过,业务值仍需要范围和权限验证。
设计 schema 时区分必填与可选字段,使用枚举表达有限状态,并为版本升级保留兼容策略。
官方文档图片
以下图片直接来自本页引用的官方资料,本站保存本地副本并保留逐图来源。
函数调用

官方资料
本页由 xueai 根据 OpenAI 官方资料重新组织并用中文讲解。产品会持续更新,涉及版本、模型和命令时请同时核对下列官方页面。