GoogleとSpeakeasyがOpenAPIジェネレーターをオープンソース化、エージェント向けCLIとドキュメントMCPを同一コンパイルパイプラインに統合

GoogleとSpeakeasyは9月17日、Goで実装したOpenAPIジェネレーターを公開した。これはすでにGoogle GenAIのInteractions、Agents、Webhooks APIクライアントに使用されている。生成プロセスでは、まず仕様を解析・検証し、SDKに最適化された抽象構文木を構築する。次に各言語のテンプレートとTypeScript helperを読み込み、最後に出力をフォーマットし、必要に応じてコンパイルする。この決定論的なパイプラインは、モデルに直接「ドキュメントを基にSDKを書かせる」手法とは異なり、ストリーミング、エラー型、リトライ、ページネーションの挙動を言語間で一貫させることを目的としている。

公開リポジトリには、C#、Go、Java、PHP、Python、Ruby、TypeScript、Unity SDKに加え、TypeScript MCP server、CLI、Postman collection、Terraform providerを含む、主要な12種類の出力が挙げられている。Googleによると、現在のパイプラインは6つのターゲットをカバーし、そのうち3つのSDKがすでに公開されている。保守に必要な人員は約1人のエンジニアだという。カスタマイズ部分はAntigravityエージェントで高速化できるが、正式な仕様変換は引き続き再現可能なジェネレーターが担う。

エージェント開発では、2つの新しい出力が特に有用だ。CLIジェネレーターにより、coding agentは一時的にHTTPリクエストを組み立てることなく、ターミナルから直接APIを呼び出せる。ドキュメントMCPジェネレーターは、OpenAPIとMarkdownを検索可能なサーバーへ変換し、エージェントが古いメソッド名やパラメーターを推測してしまう可能性を低減する。これは、API仕様、SDK、コマンドラインツール、エージェント向けツール記述を単一のソースから更新できることも意味し、CIで差分や乖離を検出しやすくなる。

ただし、ライセンスと再現性には依然として制約がある。ジェネレーター自体はAGPL-3.0で提供される。公開モードでは、生成物へのAGPL適用を明示的に選択する必要がある一方、商用ライセンスでは有効期限付きtokenを通じて生成物のライセンスをカスタマイズできる。また、リポジトリでは、デフォルトのテレメトリにサーバーURL、仕様のタイトル、ワークスペース識別子、検証エラーが含まれる可能性があることも開示されており、環境変数で無効化できる。完全なsnapshot companionは引き続き非公開で、公開PRには集約された結果のみが返される。導入前に、チームはストリーミングの互換性をテストし、テレメトリを無効化または監査したうえで、生成ファイルおよびジェネレーターを変更する場合のライセンス上の義務について法務部門の確認を受けるべきだ。