mcpField
A
a2ui

a2ui

github.com/a2ui-project開発17.4k141 回インストール2 日前に更新
リポジトリ

a2ui について

a2uiは、エージェントが生成するUI向けのオープンなプロトコルとレンダラーライブラリです。複数プラットフォームへの対応や、リモートで信頼できないエージェントを扱うアプリ開発者向けで、クライアント側の信頼できるコンポーネントでレイアウトデータを描画し、コード実行を避けます。

主な機能

  1. 01レイアウトデータによるUI記述
  2. 02信頼できるクライアント部品で描画
  3. 03複数のUIプラットフォームに対応
  4. 04リモートエージェントとの信頼境界に対応

活用シーン

  1. 01FlutterとWebでエージェントUIを表示
  2. 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 プロトコルとレンダラーライブラリです。 エージェントはレイアウトデータ(サーフェス、カタログ内のコンポーネント、データモデル)を送信します。クライアントは独自の信頼できるコンポーネントを使ってこれをレンダリングするため、コードは実行されず、ホストアプリは独自のデザインシステムを維持できます。

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)があり、それぞれメッセージ名が異なります。学習データは古くなっている可能性があります。

  1. インストール済みパッケージの README とドキュメントを確認してください(例:node_modules/@a2ui/react/README.md)。
  2. それ以外の場合は、https://a2ui.org/llms.txt と、そこからリンクされているお使いのフレームワークのページを確認してください。
  3. レンダラーと 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 専用です。
  4. ドキュメントに記載がない場合は、その旨を伝えてください。メッセージ名やフィールド名を推測しないでください。

インストール(現行のパッケージ名)

プラットフォームインストール
Reactnpm install @a2ui/react @a2ui/web_core
Angularnpm install @a2ui/angular @a2ui/web_core
Lit / Web Componentsnpm install @a2ui/lit @a2ui/web_core
Flutterflutter pub add a2ui_flutter a2ui_core(READMEを参照)
SwiftUI(アルファ版)swift/swiftuiを参照
Jetpack Compose(アルファ版)https://developer.android.com/develop/ui/compose/agentic
エージェント、Pythonpip install a2ui-agent-sdk
エージェント、TypeScriptnpm 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 のガイドを参照してください。

コメント