AG-UIとは?
AG-UI(Agent-User Interaction protocol)は、エージェントのバックエンドが人の使うアプリとどう通信するかを定めます。アプリはHTTPエンドポイントに1つのRunAgentInput(メッセージ、フロントエンドが提供するツール、共有状態、コンテキスト)を送り、エージェントは型付きのイベントをストリーミングで返します。イベントは8つのファミリーに31種類あり、実行のライフサイクル、テキスト、ツール呼び出し、状態のスナップショットとJSON Patchの差分、推論、進捗、サブエージェント、カスタムデータを扱います。トランスポートはServer-Sent Events付きのHTTPか、バイナリのProtobufバインディングです。
ほかの2つのエージェント用プロトコルと競合するのではなく、並んで使うものです。MCPはエージェントをツールやデータに、A2Aはエージェント同士を、AG-UIはエージェントを利用者につなぎます。1つのエージェントが3つすべてを使うことも多く、AG-UIのミドルウェアはMCPやA2Aのエージェントの前段に置けます。GoogleのA2UIやMCP Appsのような生成UIの仕様は何を描くかを記述し、AG-UIはその中身を運びます。
バージョン1.0は2026年9月17日に公開され、規範的な仕様とJSON Schemaを備えています。公式のTypeScript、Python、.NETのSDKはこのスキーマから生成され、Kotlin、Go、Java 、Dart、Rust、Ruby、C++、SwiftのSDKはコミュニティ製です。CopilotKitがこのプロトコルを作り、MITライセンスで公開しながら保守しています。
AG-UIは使う価値があるか?
AG-UIは、どのチームも下手に作り直しがちな部分を解決します。バックエンドのエージェントから、ストリーミングのテキスト、ツール呼び出し、共有状態、承認依頼をブラウザへ届ける処理を、フレームワークごとに独自のイベント形式を作らずに済ませられます。普及の数字を見ると、この点ではほぼ勝負がついています。@ag-ui/coreは2026年11月19日までの1週間にnpmで約760万回、Pythonパッケージag-ui-protocolは約230万回ダウンロードされました。リポジトリには約20,800のGitHubスターがあります。
理由はフレームワークの対応です。Microsoft Agent Framework、Google ADK、AWS Strands、Mastra、Pydantic AI、Agno、LlamaIndex、AG2が組み込みで対応し、LangChainとCrewAIはパートナーとして挙げられ、Claude Agent SDKとOpenAI Agentsの統合はリポジトリ内にあり、Amazon Bedrock AgentCoreは自社ランタイム向けにAG-UIを文書化しています。CopilotKitやターミナルのフロントエンドの裏にあるエージェントのフレームワークを入れ替えても、書き直しではなく設定変更で済みます。
2026年9月17日の1.0リリースで、動作の定義はTypeScriptクライアントの実装から、MUSTやSHOULDの規則を持つ文書化された仕様に移りました。実行は結果(成功、中断、キャンセル)を報告するようになり、人による承認をきれいな一時停止と再開として扱えます。THINKINGイベントは暗号化した往復に対応するREASONINGイベントになり、ツールの結果には画像や文書を含められます。旧版と新版は双方向に相互運用できるので、0.xのエージェントは1.0のクライアントでも動き、その逆も同様です。
注意点:このプロトコル自体には認証も認可もありません。MicrosoftのAG-UIセキュリティガイドはそのことをはっきり述べ、AG-UIサーバーをブラウザのJavaScriptやモバイルアプリに直接公開しないよう勧めています。また、クライアントは任意のシステムメッセージ、ツール、状態を送れるため、メッセージ一覧と状態がプロンプトインジェクションの主な経路だと指摘しています。スレッドIDは認証情報ではありません。実際には、プロトコルのメッセージを自ら組み立て、利用者のテキストだけを通す信頼できるバックエンドを前段に置きます。リリースの間隔も短く、11月は数日おきにタグ付きリリースが出ており、未解決のissueは318件あります。
結論:エージェントに本格的なユーザーインターフェースが必要なら、ツールにおけるMCPと同じように、AG-UIを標準として選ぶのが妥当です。仕様が意図的に利用者へ任せているセキュリティまわりの作業に、1日は見込んでおいてください。
真価を発揮する場面
アプリ内アシスタントを追加するSaaS企業のフロントエンドエンジニア
ストリーミングの回答、ツールの進捗、危険な操作に対する承認または拒否の手順を表示する
`npx create-ag-ui-app@latest`を実行し、バックエンドのフレームワークとNext.js上のCopilotKitを選び、中断の結果を確認ダイアログに対応づけます。プロトコルは無料で、費用はモデル呼び出しとエージェントのホスティングです。
2つのフレームワークでエージェントを動かす銀行のプラットフォームチーム
バックエンドをLangGraphからMicrosoft Agent Frameworkへ移す間も、チャットのフロントエンドを1つに保つ
どちらもAG-UIイベントを出すので、クラ イアントは変わりません。Microsoftのセキュリティガイドが勧めるとおり、利用者を認証し、RunAgentInputを自ら組み立て、利用者のテキストだけを転送するbackend-for-frontendのサービスを前段に置きます。
既存のエージェントで社内向けSlackボットを作る開発者
Webのエージェントを、2つ目の統合なしにSlackとTeamsで再利用する
CopilotKitのチャネルSDKはWebクライアントと同じAG-UIストリームを受け取るため、エージェントのコードは変わりません。チャネルごとに違うのは、ツール呼び出しと状態の表示方法だけです。
導入前に確認すること
- 導入
- npm install @ag-ui/clientまたはpip install ag-ui-protocolを実行します。最小構成のPythonエージェントとTypeScriptクライアントはそれぞれ約30行です。`npx create-ag-ui-app@latest`なら、フレームワークにつながったCopilotKitアプリの雛形を作れます(テンプレートはOpenAIを呼び出します)。
- 連携
- Microsoft Agent Framework、Google ADK、AWS Strands、Mastra、Pydantic AI、Agno、LlamaIndex、AG2、LangChain、CrewAI、Claude Agent SDK、OpenAI Agents、Spring AIなど。React、Angular、Vue、React Native、Slack、Teams、ターミナル向けのクライアントと、MCPお よびA2A用のミドルウェアがあります。
- データとプライバシー
- サービスではなくプロトコルなので、イベントは自分のアプリとエージェントの間だけを流れます。認証は定義されていないため、エンドポイントには独自の認証と前段の信頼できるバックエンドが必要です。ライセンスはMITです。
- 大規模利用時のコスト
- ライセンス料も利用料もありません。費用は、エージェントのホスティング、モデルのトークン、ロードバランサー上の長時間のストリーミング接続です。
- 制限
- Python SDKは3.9+、TypeScriptクライアントはNode.js 20+が必要です。1.0は未知のイベントを警告付きで破棄し、形式が壊れた既知のイベントを致命的エラーとして扱うため、SDKのバージョンの不一致は実行時エラーとして表れます。
良い点
- Microsoft、Google、AWSを含む主要なエージェントフレームワークの 多くに組み込み済み
- 固定された1.0仕様とJSON Schemaから、TypeScript、Python、.NETのSDKを生成
- 中断の結果により、人の承認をきれいな一時停止と再開にできる
- JSON Patchの差分による共有状態で、アプリとエージェントを同期
- Dojoで各統合のライブデモを確認できる
気になる点
- 認証が組み込まれておらず、エンドポイントをブラウザに直接公開してはいけない
- 信頼できないクライアントからは、メッセージと状態がプロンプトインジェクションの経路になる
- Kotlin、Go、RustなどのSDKはコミュニティ保守で、スキーマから生成されていない
- リリースが頻繁で、未解決のissueが318件
おすすめの人
LangGraph、ADK、Mastra、CrewAIなどで作ったエージェントをWeb、モバイル、チャットの画面の裏に置き、すべてに共通のイベント形式を使いたいチームに向いています。
AG-UIの代替
AG-UI:よくある質問
- AG-UIは使う価値があるか?
- AG-UIはエージェントのバックエンドとフロントエンドをつなぐ標準の通信形式になり、1.0仕様によって安心して採用できるものになりました。ただし、省かれている認証は自分で用意する必要があります。 評価は5点満点中4.3点です。
- AG-UIの料金は?
- MITライセンスの無料オープンソースで、プロトコル、SDK、統合、デモアプリDojoが含まれます。費用はエージェントのホスティングとモデル呼び出しにかかります。
- AG-UIの欠点は?
- 認証が組み込まれておらず、エンドポイントをブラウザに直接公開してはいけない; 信頼できないクライアントからは、メッセージと状態がプロンプトインジェクションの経路になる; Kotlin、Go、RustなどのSDKはコミュニティ保守で、スキーマから生成されていない; リリースが頻繁で、未解決のissueが318件.
- AG-UIは誰に向いているか?
- LangGraph、ADK、Mastra、CrewAIなどで作ったエージェントをWeb、モバイル、チャットの画面の裏に置き、すべてに共通のイベント形式を使いたいチームに向いています。
- チームや本番環境でAG-UIを使うと費用はいくらか?
- ライセンス料も利用料もありません。費用は、エージェントのホスティング、モデルのトークン、ロードバランサー上の長時間のストリーミング接続です。
- AG-UIは企業データを扱っても安全か?
- サービスではなくプロトコルなので、イベントは自分のアプリとエージェントの間だけを流れます。認証は定義されていないため、エンドポイントには独自の認証と前段の信頼できるバックエンドが必要です。ライセンスはMITです。
- AG-UIの代わりになるものは?
- 当サイトでレビューした中で最も近い代替はMCP Python SDK, Mastra, LangGraph 、 Google Agent Development Kit (ADK)です。
回答確認日:2026年11月20日