返回首頁

開源開發工具

Google 與 Speakeasy 開源 OpenAPI 生成器,把代理 CLI 與文件 MCP 納入同一編譯管線

Google 採用 Speakeasy 重建 GenAI SDK 管線後,雙方公開可由 OpenAPI 生成多語言 SDK、CLI、MCP 伺服器與 Terraform provider 的核心程式。工具降低 AI API 介面演進的維護成本,但 AGPL、輸出授權、預設遙測與部分私有測試仍需要導入者仔細評估。

Gciriani · CC BY-SA 4.0 · Image source
zh-Hant

Google 與 Speakeasy 9 月 17 日公開一套 Go 實作的 OpenAPI 生成器。它已被用於 Google GenAI 的 Interactions、Agents 與 Webhooks API 客戶端:生成流程先解析及驗證規格,建立偏向 SDK 的抽象語法樹,再載入各語言模板與 TypeScript helper,最後格式化並可選擇編譯輸出。這種確定性管線與讓模型直接「照文件寫 SDK」不同,目標是讓串流、錯誤型別、重試及分頁在不同語言維持一致。

公開倉庫列出 12 種主要輸出,包括 C#、Go、Java、PHP、Python、Ruby、TypeScript、Unity SDK,以及 TypeScript MCP server、CLI、Postman collection 和 Terraform provider。Google 稱目前管線涵蓋六個目標,其中三個 SDK 已發布,維護人力約為一名工程師;客製部分可交由 Antigravity 代理加速,但正式規格轉換仍由可重現的生成器負責。

對代理開發而言,兩個新增輸出特別實用。CLI 生成器讓 coding agent 直接在終端呼叫 API,不必臨時拼接 HTTP;文件 MCP 生成器則把 OpenAPI 與 Markdown 轉成可查詢伺服器,降低代理臆測舊方法名稱或參數的機率。這也意味著 API 規格、SDK、命令列工具與代理工具描述可以由同一來源更新,較容易在 CI 中檢查漂移。

授權與可重現性仍有邊界。生成器本身採 AGPL‑3.0;公開模式要求明確選擇 AGPL 輸出,商業授權則透過會到期的 token 允許自訂產物授權。倉庫同時揭露預設遙測可能包含伺服器 URL、規格標題、工作區識別碼及驗證錯誤,可用環境變數關閉;完整 snapshot companion 仍是私有,只向公開 PR 回傳彙總結果。團隊採用前應測試串流相容性、關閉或審核遙測,並由法務確認生成檔案及修改生成器時的授權義務。

來源

  1. Why client SDK generation belongs in the open
  2. Speakeasy OpenAPI Generation