第六部分,OpenAI SDK 与 API

函数调用与结构化输出

用 JSON Schema 定义工具和输出,建立参数验证、执行审批和结果回传闭环。

函数调用把意图变成参数

函数调用让模型选择应用提供的工具并生成结构化参数。模型不会替你执行函数,应用必须校验参数、检查权限、运行代码,再把结果返回给模型。

工具描述要清楚说明用途和限制,schema 尽量收窄。不要用一个包含任意命令或任意 URL 的万能工具。

  1. 定义工具名称、说明和 JSON Schema。
  2. 把工具随请求提供给模型。
  3. 解析工具调用并验证参数。
  4. 执行权限和业务规则检查。
  5. 运行工具并返回结构化结果。
  6. 继续响应直到得到最终答案。

结构化输出约束最终数据

当下游代码需要稳定字段时使用结构化输出。Python 可以从 Pydantic 模型生成 schema,JavaScript 可以配合 Zod。即使结构校验通过,业务值仍需要范围和权限验证。

设计 schema 时区分必填与可选字段,使用枚举表达有限状态,并为版本升级保留兼容策略。

官方文档图片

以下图片直接来自本页引用的官方资料,本站保存本地副本并保留逐图来源。

函数调用

官方资料

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