OpenAPI

OpenAI 的 Function Calling 和 Anthropic 的 Tool Use API 都是 ReAct 模式的标准化实现

OpenAPI/Swagger规范驱动的API开发是规格驱动开发理念的成功实践，先定义接口规格再自动生成服务端框架和客户端SDK

Swagger已更名为OpenAPI Specification，是一套用于描述RESTful API的标准化规范，以JSON或YAML格式定义API信息，目前业界广泛使用OpenAPI 3.0/3.1版本

FastAPI自动生成符合OpenAPI 3.0规范的JSON描述文件，支持Swagger UI和ReDoc两种文档风格

该学习路线定义了基于Swagger/API文档的五类接口测试用例自动生成策略：正向、反向、错误、模糊需求和数据编码场景

多Agent系统中前后端Agent间的状态同步与接口契约是核心工程挑战，业界通常通过共享Schema定义或中间协调层来解决

早期ChatGPT插件采用OpenAPI规范描述接口，通过函数调用（Function Calling）机制与第三方API交互

LibreChat支持OpenAPI规范的Actions和Functions调用，用户通过定义OpenAPI schema即可扩展AI能力

业界通常用API-First开发方法论（如OpenAPI/Swagger定义接口契约）来解决前后端接口对齐问题

OpenAPI/Swagger 规范允许团队将 API 文档定义为机器可读的契约，并通过 Contract Testing 工具（如 Pact）在 CI 流水线中持续验证服务行为与文档描述的一致性

Draft 7 是目前最广泛使用的 JSON Schema 版本，被大量工具库和 OpenAPI 2.x/3.x 规范采用

在 Cognipeer Console 中创建 MCP 服务器时，可以在 Tool Source 中选择 OpenAPI，并通过粘贴 JSON/YAML、上传文件或从 URL 加载来提供 OpenAPI 规范

Custos可通过读取服务的OpenAPI规范自动发现并识别服务暴露出的工具，无需人工逐一定义每个操作

将OpenAPI规范作为唯一数据源，下游SDK、文档站点、MCP服务器均由此派生，可消除代码与文档之间的版本漂移

Octri.dev可从一份OpenAPI规范自动生成可定制的文档网站、十种语言的客户端SDK、一个MCP服务器以及对应的监控能力

Executor 除 MCP Server 外还支持 OpenAPI、GraphQL 以及 Google Discovery，只要接口能用 JSON Schema 描述就能统一转换成 Agent 可调用的工具

前后端分离架构的典型开销包括维护独立 API 契约、管理跨域与认证重复逻辑、同步类型定义、独立的前端 CI/CD 流水线

在工程实践中，类型化决策通常借助 JSON Schema、Pydantic 模型或 OpenAPI 规范来定义决策的结构约束

批评者认为当大模型本身已经能够理解自然语言描述的 API 时，直接让模型读取 OpenAPI 规范或函数签名可能比引入新协议更简洁

Ruby UTCP 的 OpenAPI discovery 功能能够解析现有 OpenAPI 文档，自动提取端点并转化为 UTCP 工具定义