OpenAPI
目前描述REST API最广泛使用的标准规范（前身为Swagger），以JSON或YAML格式定义接口路径、请求参数、响应结构及认证方式，是业界事实标准
核心事实
时间轴 (近 90 天)
将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 工具定义
标准化的技能描述格式（如类似OpenAPI规范的元数据标准）和自动化质量评估机制可能是Agent技能市场规模化的前提条件
Cortex 支持 OpenAPI、AsyncAPI、GraphQL、gRPC 和 OpenRPC 五类 API 规范作为输入格式
A2A Net只需提供OpenAPI规范文档或MCP服务器地址，5分钟内即可完成Agent的创建和部署
还有 7 条时间轴事件
全部知识事实 (20)
OpenAI 的 Function Calling 和 Anthropic 的 Tool Use API 都是 ReAct 模式的标准化实现
80%已验证OpenAPI/Swagger规范驱动的API开发是规格驱动开发理念的成功实践，先定义接口规格再自动生成服务端框架和客户端SDK
75%已验证Swagger已更名为OpenAPI Specification，是一套用于描述RESTful API的标准化规范，以JSON或YAML格式定义API信息，目前业界广泛使用OpenAPI 3.0/3.1版本
70%待验证FastAPI自动生成符合OpenAPI 3.0规范的JSON描述文件，支持Swagger UI和ReDoc两种文档风格
95%待验证早期ChatGPT插件采用OpenAPI规范描述接口，通过函数调用（Function Calling）机制与第三方API交互
85%待验证该学习路线定义了基于Swagger/API文档的五类接口测试用例自动生成策略：正向、反向、错误、模糊需求和数据编码场景
85%待验证多Agent系统中前后端Agent间的状态同步与接口契约是核心工程挑战，业界通常通过共享Schema定义或中间协调层来解决
80%待验证LibreChat支持OpenAPI规范的Actions和Functions调用，用户通过定义OpenAPI schema即可扩展AI能力
60%待验证业界通常用API-First开发方法论（如OpenAPI/Swagger定义接口契约）来解决前后端接口对齐问题
60%待验证将OpenAPI规范作为唯一数据源，下游SDK、文档站点、MCP服务器均由此派生，可消除代码与文档之间的版本漂移
50%待验证Octri.dev可从一份OpenAPI规范自动生成可定制的文档网站、十种语言的客户端SDK、一个MCP服务器以及对应的监控能力
50%待验证Executor 除 MCP Server 外还支持 OpenAPI、GraphQL 以及 Google Discovery，只要接口能用 JSON Schema 描述就能统一转换成 Agent 可调用的工具
50%待验证前后端分离架构的典型开销包括维护独立 API 契约、管理跨域与认证重复逻辑、同步类型定义、独立的前端 CI/CD 流水线
50%待验证在工程实践中，类型化决策通常借助 JSON Schema、Pydantic 模型或 OpenAPI 规范来定义决策的结构约束
50%待验证批评者认为当大模型本身已经能够理解自然语言描述的 API 时，直接让模型读取 OpenAPI 规范或函数签名可能比引入新协议更简洁
50%待验证Ruby UTCP 的 OpenAPI discovery 功能能够解析现有 OpenAPI 文档，自动提取端点并转化为 UTCP 工具定义
50%待验证Cortex 支持 OpenAPI、AsyncAPI、GraphQL、gRPC 和 OpenRPC 五类 API 规范作为输入格式
50%待验证A2A Net只需提供OpenAPI规范文档或MCP服务器地址，5分钟内即可完成Agent的创建和部署
50%待验证AUX 的机器接口暴露了标准的发现工件，包括 OpenAPI 规范和遵循 .well-known 约定的元数据
50%待验证在 Agent 主导的世界里，元数据本身即产品说明书，任何在文档里说清但在 OpenAPI 里没体现的信息对 Agent 来说等于不存在
50%