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 格式),按其中说明在我的环境里完成安装和配置。