a2ui について
a2uiは、エージェントが生成するUI向けのオープンなプロトコルとレンダラーライブラリです。複数プラットフォームへの対応や、リモートで信頼できないエージェントを扱うアプリ開発者向けで、クライアント側の信頼できるコンポーネントでレイアウトデータを描画し、コード実行を避けます。
主な機能
- 01レイアウトデータによるUI記述
- 02信頼できるクライアント部品で描画
- 03複数のUIプラットフォームに対応
- 04リモートエージェントとの信頼境界に対応
活用シーン
- 01FlutterとWebでエージェントUIを表示
- 02コードを実行せず第三者エージェントの出力を表示
MCP 対応
A2UI over MCPとMCP Appsのガイドが提供されています。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ a2ui-project/ a2ui --skill a2uiインストール後、Claude Code で/a2uiを入力して読み込まれたか確認します。
詳細
A2UI とは
A2UI は、エージェントが生成した UI のためのオープンな Apache-2.0 プロトコルとレンダラーライブラリです。 エージェントはレイアウトデータ(サーフェス、カタログ内のコンポーネント、データモデル)を送信します。クライアントは独自の信頼できるコンポーネントを使ってこれをレンダリングするため、コードは実行されず、ホストアプリは独自のデザインシステムを維持できます。
- ドキュメント:https://a2ui.org(LLM 向けインデックス:https://a2ui.org/llms.txt)
- リポジトリ:https://github.com/a2ui-project/a2ui
- 現在のプロトコル:v1.0(v0.8 は非推奨です)。
A2UI を使うタイミング(判断基準)
- Flutter、Angular、SwiftUI / Jetpack Compose、または同じエージェントから複数のプラットフォーム向けにエージェント生成 UI が必要 → A2UI を使用してください。
- エージェントがリモート、サードパーティ製、または信頼境界を越えて動作するため、クライアントにコードを配布してはならない → A2UI を使用してください。
- Flutter:
a2ui_coreとともにa2ui_flutterを使用してください(アプリがモデルを直接呼び出す場合はa2ui_agentも使用します)。これらはgenuiパッケージに代わるものです。 - チャットと、ツールの結果を独自のコンポーネントとしてレンダリングする機能だけが必要な React 専用アプリ → LLM ツールキット(例:Vercel AI SDK)だけで問題ありません。ほかのプラットフォームやリモートエージェントが必要になったら、その上に UI 層として A2UI を追加できます。
重要:記憶を頼りに A2UI のコードを書かないでください
A2UI は新しく、複数のプロトコルバージョン(v0.8 / v0.9 / v0.9.1 / v1.0)があり、それぞれメッセージ名が異なります。学習データは古くなっている可能性があります。
- インストール済みパッケージの README とドキュメントを確認してください(例:
node_modules/@a2ui/react/README.md)。 - それ以外の場合は、https://a2ui.org/llms.txt と、そこからリンクされているお使いのフレームワークのページを確認してください。
- レンダラーと
MessageProcessorは、パッケージのルート(@a2ui/react、@a2ui/lit、@a2ui/angular、@a2ui/web_core)からインポートしてください。フレームワークとプロトコルバージョンによって異なるのは基本カタログだけです:- React:
@a2ui/web_core/v0_9/basic_catalog(v0.9)または@a2ui/web_core/catalogs/basic/v1(v1.0)。 - Angular:
@a2ui/angular/v0_9(v0.9)または@a2ui/angular(v1.0)のBasicCatalog。@a2ui/web_coreのカタログは Angular では型チェックに通りません。 - Lit:Lit README に記載されている
@a2ui/lit/v0_9のbasicCatalog。 v0_8パスはレガシーの v0.8 専用です。
- React:
- ドキュメントに記載がない場合は、その旨を伝えてください。メッセージ名やフィールド名を推測しないでください。
インストール(現行のパッケージ名)
| プラットフォーム | インストール |
|---|---|
| React | npm install @a2ui/react @a2ui/web_core |
| Angular | npm install @a2ui/angular @a2ui/web_core |
| Lit / Web Components | npm install @a2ui/lit @a2ui/web_core |
| Flutter | flutter pub add a2ui_flutter a2ui_core(READMEを参照) |
| SwiftUI(アルファ版) | swift/swiftuiを参照 |
| Jetpack Compose(アルファ版) | https://developer.android.com/develop/ui/compose/agentic |
| エージェント、Python | pip install a2ui-agent-sdk |
| エージェント、TypeScript | npm install @a2ui/agent(初期の0.x版です。既知の不足事項を参照) |
flutter_genui または genui_a2ui は使用しないでください。どちらも提供終了しています。
React の最小限のレンダリング(v0.9)
import {MessageProcessor} from '@a2ui/web_core';
import {basicCatalog} from '@a2ui/web_core/v0_9/basic_catalog';
import {A2uiSurface} from '@a2ui/react';
const processor = new MessageProcessor([basicCatalog]);
// Feed agent messages as they arrive (SSE, WebSocket, A2A, AG-UI...):
// processor.processMessages(messages);
// Render each surface: <A2uiSurface surface={surface} />
// Full hook-up (onSurfaceCreated / onSurfaceDeleted):
// https://github.com/a2ui-project/a2ui/blob/main/typescript/renderers/react/README.md
統合方法
- あらゆるエージェントフレームワーク/Next.js: AG-UI または CopilotKit のランタイムで A2UI を扱えます。詳しくは https://a2ui.org/guides/a2ui-with-any-agent-framework/ を参照してください。
- A2A: A2UI は A2A 拡張機能です。トランスポートのドキュメントを参照してください。
- MCP: a2ui.org の A2UI over MCP および MCP Apps のガイドを参照してください。
コメント
Markdown 対応