ag-ui — AIエージェントとフロントエンドを繋ぐ対話プロトコル
ag-ui-protocol/ag-ui
★ 17,371 ・ TypeScript ・ MIT
概要
AIエージェント技術の発展に伴い、LLM(大規模言語モデル)を用いたエージェントを実際のフロントエンドアプリケーションに組み込む需要が急速に高まっています。しかし、エージェントのバックエンドとWebなどのクライアントUIを接続する実装は、これまでプロジェクトごとに独自の方法で作られることが多く、統一された標準が存在していませんでした。
ag-ui(Agent-User Interaction Protocol)は、AIエージェントとユーザー向けアプリケーションの通信仕様を標準化するために策定された、オープンで軽量なイベント駆動型プロトコルです。CopilotKitとLangChain、CrewAIのパートナーシップから生まれ、オープンソースとして公開されています。
エージェントの実行状態をリアルタイムにフロントエンドへ伝えたい開発者や、ユーザーの入力・状態をエージェントに双方向で同期させたいエンジニアに向いているプロジェクトです。
主な特徴
- ストリーミング対応のリアルタイムエージェントチャット: エージェントの生成プロセスや実行経過をストリーミング形式で受け取り、UIへリアルタイムに表示できます。
- 双方向の状態同期(Bi-directional state synchronization): フロントエンドのUI状態とエージェントバックエンドの状態を相互に同期させ、一貫したコンテキストを保ちます。
- 生成UI(Generative UI)と構造化メッセージのサポート: 単なるプレーンテキストの応答にとどまらず、構造化されたデータや動的なUIコンポーネントを描画するためのイベント連携に対応しています。
- リアルタイムなコンテキスト付与(Context enrichment): ユーザーの操作や閲覧中の画面情報など、フロントエンド側の動的なコンテキストをエージェントの推論プロセスにリアルタイムで提供できます。
- フロントエンドツール連携とヒューマン・イン・ザ・ループ: エージェントがブラウザ側のツールを呼び出す処理や、人間の承認や追加介入を挟むコラボレーションフローに対応しています。
使い方
AG-UIを採用した新規アプリケーションを作成するためのCLIツールが提供されています。以下のコマンドを実行することで、スターターアプリケーションを迅速に初期化できます。
npx create-ag-ui-app my-agent-app
また、公式リソースとして以下のリンクが案内されています。
- The AG-UI Dojo: 機能ごとのデモ環境が用意されています。
- Quickstart ドキュメント: AG-UIを利用したアプリケーション構築の導入手順が解説されています。
- フレームワーク向け統合ガイド: 独自のフレームワークやバックエンドにAG-UIを組み込むためのドキュメントです。
技術的なポイント
エージェントプロトコルスタックにおける位置付け
READMEでは、AG-UIが既存の代表的なエージェント向けプロトコルと競合するものではなく、補完関係にあると説明されています。
- MCP(Model Context Protocol): エージェントに外部ツールやリソースへのアクセス手段を提供するプロトコル
- A2A(Agent-to-Agent): エージェント同士が相互に通信するためのプロトコル
- AG-UI: エージェントを人間が利用するフロントエンドアプリケーションへ接続するためのプロトコル
このように、ツール利用(MCP)や協調動作(A2A)と並び、ユーザーインターフェースとの接点を担う役割として定義されています。
仕様とミドルウェア層
AG-UIの通信はイベントベースで設計されており、エージェントの実行バックエンドは約16種類の標準イベントタイプに準拠したイベントを発行します。また、バックエンド側も少数のシンプルなAG-UI互換入力を引数として受け取る形をとります。
柔軟性を担保するため、AG-UIにはミドルウェア層が含まれています。
- トランスポート非依存: SSE(Server-Sent Events)、WebSockets、Webhooksなど、任意の通信プロトコル上で動作させることができます。
- 柔軟なフォーマットマッチング: 厳密すぎる固定スキーマではなく緩やかなイベントフォーマットマッチング(loose event format matching)を採用しており、多様なエージェント実装やアプリケーション間で相互運用が可能です。
- リファレンス実装: 初回導入を支援するために、リファレンス用のHTTP実装とデフォルトコネクタが同梱されています。
豊富なエコシステムとSDK
主要なエージェントフレームワークとのインテグレーションが幅広く用意されています。
- パートナーシップ: LangChain(LangGraph)、CrewAI
- 1st Party サポート: Microsoft Agent Framework、Google ADK、Google Antigravity、AWS Strands Agents、Mastra、Pydantic AI、Agno、LlamaIndex、AG2
- コミュニティ統合: Claude Agent SDK、Claude Managed Agents SDK、Langroid、Omnara、Cloudflare Agents
- インフラ・仕様連携: Amazon Bedrock AgentCore(デプロイ環境)、Oracle Agent Spec、MCP Apps(生成UI仕様)
言語別SDKとしては、TypeScript/JavaScript以外にも、コミュニティ主導でKotlin、Go、Dart、Java、Rust、Ruby向けのSDK開発が進められています。
注意点
- ライセンス: リポジトリのライセンスはMITライセンスとして公開されています。
- 開発途上のインテグレーション: OpenAI Agents SDKやAWS Bedrock Agentsなど、一部のフレームワーク統合については「In Progress(開発中)」と明記されています。採用予定のフレームワークがサポート済みかどうか、公式ドキュメントやREADMEの対応表を確認する必要があります。
- プロトコルの理解: エージェントとUIの協調動作を行うためには、約16種類の標準イベントのライフサイクルや、双方向同期の仕組みを理解した上で実装を進める必要があります。
まとめ
AG-UIは、AIエージェントとフロントエンドアプリケーション間の相互作用をイベント駆動で標準化するオープンプロトコルです。ストリーミングや生成UI、双方向の状態同期といった現代的なエージェント対話に必要な要素を包括的にカバーしています。MCPやA2Aと組み合わせることで、実用的なエージェント対応Webアプリケーションを効率的に構築したい開発者にとって重要な仕様となるでしょう。





