pi-openapi-tools
从OpenAPI/Swagger URL自动生成LLM工具的Pi插件
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:pi-openapi-tools。 它的用途是:从OpenAPI/Swagger URL自动生成LLM工具的Pi插件 完整的 Skill 内容见:https://321skill.com/skills/pi-openapi-tools/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用pi-openapi-tools,为这个天气API文档生成工具。” 它会解析您提供的OpenAPI URL,并创建出‘获取当前天气’、‘查询预报’等工具。之后,您可以直接让AI“调用获取天气工具,查询北京的天气”,AI便能使用生成好的工具结构去调用真实的API。
介绍
这个Skill解决了开发者在集成或调用各类Web API时需要手动编写大量工具代码的繁琐问题。它通过解析用户提供的OpenAPI或Swagger规范URL,自动生成可供大型语言模型(如Claude、GPT)直接调用的工具函数,将API文档瞬间转化为可执行的AI能力。
使用方式非常简单:在Pi平台安装此插件后,只需提供一个有效的OpenAPI/Swagger规范URL,它就能自动解析并生成对应的工具集。开发者无需深入了解每个API的细节,即可让AI助手具备调用这些外部服务的能力,极大简化了AI应用与现有API的集成流程。
它非常适合希望快速扩展AI助手功能范围的开发者、产品经理或技术爱好者,特别是那些需要频繁与多个外部服务(如天气、支付、社交媒体等开放API)进行交互,但又不想为每个API单独编写复杂适配代码的团队或个人。
使用建议是,确保提供的OpenAPI/Swagger URL是公开可访问且格式规范的,以获得最佳解析效果。对于需要复杂认证(如OAuth 2.0)或包含大量非标准扩展的API,可能需要额外的配置或手动调整。
核心特点
核心区别在于其“从URL一键生成”的自动化能力,无需手动编写任何工具描述代码。同类工具通常需要开发者手动将API文档转化为特定的工具定义格式,而此Skill直接读取标准OpenAPI规范并完成全部转换工作。
注意事项
不适合处理非标准、格式错误或需要复杂动态认证流程的OpenAPI文档。
常见问题
支持本地的Swagger JSON文件吗?
目前主要支持通过HTTP/HTTPS URL访问的在线OpenAPI规范。
生成的工具安全吗?会直接调用API吗?
它生成工具定义,实际调用由LLM和您的代码控制,需自行处理密钥等安全配置。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/pi-openapi-tools/raw/index.md 读取 pi-openapi-tools 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-openapi-tools/raw/index.md(查看排版版本)