AG-UI 統合の構築を開始する方法を学習します。AG-UI 統合は、エージェントが AG-UI プロトコルに対応できるようにすることです。
AG-UI : Get Started – クイックスタート : 統合の構築 – イントロダクション
作成 : Masashi Okumura (@classcat.com)
作成日時 : 04/14/2026
バージョン : v0.0.52
* 本記事は docs.ag-ui.com の以下のページを参考にしています :
* サンプルコードの動作確認はしておりますが、必要な場合には適宜、追加改変しています。
AG-UI : Get Started – クイックスタート : 統合の構築 – イントロダクション
イントロダクション
AG-UI 統合の構築を開始する方法を学習します。
What is an Integration?
AG-UI 統合は、エージェントが AG-UI プロトコルに対応できるようにすることです。つまり、エージェントは、チャットインターフェース、copilot、カスタム AIツールのような、任意の AG-UI 互換クライアント・アプリケーションと連携できるようになります。
エージェントに万能翻訳機を追加するようなものだと考えてください。クライアント毎にカスタム API を構築する代わりに、AG-UI を一度実装すれば、互換性のある任意のアプリケーションと即座に連携できます。
AG-UI と統合されるエージェントは、以下が可能になります :
- ストリームレスポンス – 生成されたテキストがリアルタイムに表示されます
- クライアント側ツールの呼び出し – エージェントはクライアントが定義した関数やサービスを利用できます
- 状態の共有 – エージェントの状態は双方向の共有状態になります
- 普遍的な実行 – AG-UI 互換の任意のクライアント・アプリケーションと統合できます
- And much more! – Check out the full specification here.
When should I make any integration?
探している統合が 統合ページ にリスティングされていない場合は、統合を行う必要があります。We’ve got a few guides on this below!
ただし、既存の統合（LangGraph、CrewAI、Mastra 等）を利用つもりなら、この手順をスキップして アプリケーションの構築 に直接進むことができます。
統合のタイプ
統合が必要であると判断した場合、AG-UI 統合を実装するためには主に 2 つの方法があります :
- サーバ実装 – エージェントまたはサーバから AG-UI イベントを直接出力 (emit) します。
- ミドルウェア実装 – 既存のプロトコルとアプリケーションを AG-UI イベントに変換します。
When to use a server implementation
サーバ実装は、エージェントまたはサーバから AG-UI イベントを直接出力することを可能にします。エージェントフレームワークを使用していない場合、またはエージェントフレームワーク用のプロトコルがまだ作成されていない場合は、これが最適な開始方法です。
サーバー実装は、以下のような場合にもまた適します :
- 新しいエージェントフレームワークをゼロから構築する
- イベントが出力される方法と内容を最大限に制御する
- エージェントをスタンドアロン API として公開する
When to use a middleware implementation
ミドルウェアは柔軟性の高い選択肢です。既存のプロトコルやアプリケーションを AG-UI イベントに変換することで、既存システムと AG-UI 間の橋渡しを作成します。
ミドルウェアは以下のような場合に適しています :
- 既存のプロトコルや API を普遍的に変換する
- 既存のシステムやフレームワークの制限内で作業する
- エージェントフレームワークやシステムを直接制御できない場合
以上