https://knightli.com/tags/%E5%B7%A5%E5%85%B7%E8%B0%83%E7%94%A8/ Recent content in 工具调用 on KnightLi的博客 Hugo -- gohugo.io zh-cn Sat, 06 Jun 2026 22:26:00 +0800 https://knightli.com/2026/06/06/openai-plugins-archive-guide/ Sat, 06 Jun 2026 22:26:00 +0800 https://knightli.com/2026/06/06/openai-plugins-archive-guide/ <p><code>openai/plugins</code> 是 OpenAI 早期 Plugins 相关的示例仓库。虽然今天的 OpenAI 工具体系已经演进到 function calling、tools、Agents SDK、MCP 等方向，但这个仓库仍然有参考价值：它能帮助理解“让模型调用外部工具”这件事最早是怎么产品化的。</p> <p>对现在的开发者来说，它更像历史资料和设计样本，而不是新项目的首选模板。</p> <h2 id="为什么还值得看">为什么还值得看 </h2><p>AI 工具调用的核心问题一直没变：</p> <ul> <li>模型如何知道有哪些工具；</li> <li>工具能力如何描述；</li> <li>参数如何声明；</li> <li>结果如何返回；</li> <li>权限和用户确认怎么处理；</li> <li>第三方服务如何被模型安全调用。</li> </ul> <p>Plugins 时代用 manifest、OpenAPI schema、服务端 API 等方式解决这些问题。后来的 function calling、tool calling、MCP，本质上仍然在围绕这些问题演进。</p> <h2 id="适合谁看">适合谁看 </h2><p>这个仓库适合：</p> <ul> <li>想了解 OpenAI Plugins 历史设计的人；</li> <li>做 AI 工具生态或 Agent 平台的人；</li> <li>需要理解 manifest / OpenAPI 工具描述的人；</li> <li>想比较 Plugins、function calling、MCP 差异的人；</li> <li>维护旧插件或迁移旧方案的人。</li> </ul> <p>如果你是新项目，不建议直接照搬旧 Plugins 模式。应该优先看当前官方 API、tools、Apps SDK 或 MCP 相关文档。</p> <h2 id="从中能学到什么">从中能学到什么 </h2><p>最值得学的不是某段代码，而是工具接口设计思路：</p> <ul> <li>工具描述要让模型读得懂；</li> <li>API schema 要足够明确；</li> <li>返回结果要适合模型继续推理；</li> <li>用户授权不能藏在黑盒里；</li> <li>外部工具失败时要有可理解的错误信息。</li> </ul> <p>这些原则今天依然有效。</p> <h2 id="小结">小结 </h2><p><code>openai/plugins</code> 更像 AI 工具调用早期阶段的切片。它不一定适合新项目直接使用，但很适合拿来理解“插件、工具、Agent 能力扩展”这条线如何发展。</p> <p>如果你现在做 AI Agent 工具集成，读它可以帮你看清很多设计问题的源头。</p> <h2 id="参考来源">参考来源 </h2><ul> <li><a class="link" href="https://github.com/openai/plugins" target="_blank" rel="noopener" >openai/plugins - GitHub</a></li> </ul>