AI Agent接入OpenAPI：把任意REST API变成Agent工具

世界上有上万个REST API。OpenAPI标准让Agent自动发现和调用它们——不需要写一行集成代码。

💡 你将学到

世界上有上万个REST API。OpenAPI标准让Agent自动发现和调用它们——不需要写一行集成代码。

📜 目录

• 实现三步
• 支持的API
• 总结
• 自动发现工具
• 相关文章

OpenAPI规范（以前叫Swagger）让API有了标准的描述文件。Agent读了这个文件，就知道API有哪些接口、需要什么参数、返回什么数据。

实现三步

Step 1：准备OpenAPI描述文件 大部分REST API都提供OpenAPI规范文档。

Step 2：用工具读取

from openapi_toolset import create_tools_from_spec

# 从OpenAPI规范自动生成Agent工具
tools = create_tools_from_spec("https://api.example.com/openapi.json")

Step 3：注册给Agent

for tool in tools:
    agent.register_tool(tool)

支持的API

总结

OpenAPI让Agent的"工具来源"从手写扩展到了整个互联网的API生态。任何有OpenAPI规范的REST API都能自动变成Agent的工具。

自动发现工具

import requests
from openapi_to_tool import OpenAPIToolGenerator

def discover_and_register(openapi_url):
    # 获取OpenAPI规范
    spec = requests.get(openapi_url).json()

    # 自动生成工具
    generator = OpenAPIToolGenerator(spec)
    tools = generator.generate_tools()

    # 注册给Agent
    for tool in tools:
        agent.register_tool(tool)

一行代码就能把整个REST API的几十个接口全部变成Agent工具。OpenAPI规范写得越清楚，生成的工具越好用。

相关文章

• AI Agent OpenAPI规范：API接口文档自动化
• AI Agent接入GraphQL：精准查询，不多不少
• Pydantic for LLM 2026：让任何模型输出可靠的结构化JSON