ANTIMERIDIAN
目录 →
研究与项目 / 研究文库 / OpenAI 方法论 Primer
The OpenAI Methods Primer · 04

03 · 函数调用与 OpenAPI Primer

Cookbook:Function calling with an OpenAPI specification——把 API 规格书直接变成模型的工具箱;配 Function calling: finding nearby places 的入门示例。

Chapter 4/9字符 910结构标题 4表格 0
English library directory → · 正文保留原文语言
PLATE 01 / CHAPTER STRUCTURE03 · 函数调用与 OpenAPI Primer01一句话定位02两道菜精要03方法论精华04编者注CHAPTER4/9CHARACTERS910PARAGRAPHS9TABLES0
按原文章节顺序展示前五个结构节点;不足三个标题时补入原文句子。箭头表示阅读顺序,不表示因果关系。
BOOK SKYLINE & CHAPTER POSITION · 04 / 09OpenAI 方法论 PrimerCURRENT CHARS910SECTIONS4POSITION4/9
Plate 02 · 全集 9 篇的字符数;黄色为当前篇。高度按全集最长篇归一化。
PLATE 03 / SECTIONS 1–5段落结构与篇幅 / 字符数导言 · 03 · 函数调用…120一句话定位86两道菜精要252方法论精华359编者注93
按标题至下一标题的独占区间统计非空白字符(含 Markdown 标记)。每幅图独立归一化;篇幅不代表重要性或证据强度。
核心命题结构拆解边界条件原文核验
Cookbook:Function calling with an OpenAPI specification——把 API 规格书直接变成模型的工具箱;配 Function calling: finding nearby places 的入门示例。一句话定位 → 两道菜精要 → 方法论精华 → 编者注原文《03 · 函数调用与 OpenAPI Primer》未单列边界标题;请在正文核对假设、时间与适用范围。回到下方原文核对“一句话定位”;本章 4 个结构标题、0 张表。

Cookbook:Function calling with an OpenAPI specification——把 API 规格书直接变成模型的工具箱;配 Function calling: finding nearby places 的入门示例。


一句话定位

API 即工具:给模型一份 OpenAPI spec,它就能自己挑端点、填参数、调接口——「教会模型用你的 API」从写 N 个工具定义变成递一份规格书。

两道菜精要

Function calling with an OpenAPI spec(主菜)

Finding nearby places(入门菜)

方法论精华

1. 「规格书即接口」的杠杆:世界上已有千万个 OpenAPI spec——存量 API 生态一夜之间全变成 agent 的潜在工具箱;这就是 MCP 出现前最大规模的工具接入路径。

2. 工具发现的分层:任务→相关端点→单个调用——三层里的第一层(发现)最容易被忽视:模型面对 200 个端点时的表现远差于面对筛出的 5 个。上下文预算决定工具清单长度。

3. 参数 schema 是给模型看的文档:description 写什么、enum 怎么用、required 怎么设——函数定义的质量直接决定调用质量,这是 prompt 工程在工具层的延伸。

4. 与 MCP 的关系:OpenAPI 路线是「文档驱动、静态」,MCP 是「协议驱动、动态」——前者接入存量,后者定义未来;当前生态两者并存。

编者注

对有自家 API 的团队:这篇的方法可以让你的 API 明天就被 agent 调用——写好 spec、筛好端点、写好参数描述,三步完事。证据台的连接器思路(类别占位符)是它的组织化管理版本。