openai/plugins 是 OpenAI 早期 Plugins 相關的範例倉庫。雖然今天的 OpenAI 工具體系已經演進到 function calling、tools、Agents SDK、MCP 等方向，但這個倉庫仍然有參考價值：它能幫助理解「讓模型調用外部工具」這件事最早是怎麼產品化的。
對現在的開發者來說，它更像歷史資料和設計樣本，而不是新專案的首選範本。
為什麼還值得看
AI 工具呼叫的核心問題一直沒變：
- 模型如何知道有哪些工具；
- 工具能力如何描述；
- 參數如何宣告；
- 結果如何回傳；
- 權限和使用者確認怎麼處理；
- 第三方服務如何被模型安全地呼叫。
Plugins 時代用 manifest、OpenAPI schema、服務端 API 等方式解決這些問題。後來的 function calling、tool calling、MCP，本質上仍然在圍繞這些問題演進。
適合誰看
這個倉庫適合：
- 想了解 OpenAI Plugins 歷史設計的人；
- 做 AI 工俱生態或 Agent 平台的人；
- 需要理解 manifest / OpenAPI 工具描述的人；
- 想比較 Plugins、function calling、MCP 差異的人；
- 維護舊插件或遷移舊方案的人。
如果你是新項目，不建議直接複製舊 Plugins 模式。應該優先看目前官方 API、tools、Apps SDK 或 MCP 相關文件。
從中能學到什麼
最值得學的不是某段程式碼，而是工具介面設計想法：
- 工具描述要讓模型讀得懂；
- API schema 要夠明確；
- 返回結果要適合模型繼續推理；
- 使用者授權不能藏在黑盒子裡；
- 外部工具失敗時要有可理解的錯誤訊息。
這些原則至今依然有效。
小結
openai/plugins 更像 AI 工具呼叫早期階段的切片。它不一定適合新專案直接使用，但很適合拿來理解「插件、工具、Agent 能力擴展」這條線如何發展。
如果你現在做 AI Agent 工具集成，讀它可以幫你看清很多設計問題的源頭。