エージェントシステムと標準 · 第3章(全8章)
エージェントとインターフェース:AG-UIとA2UI
AG-UIでエージェントの作業をアプリへストリーミングし、A2UIでエージェントに安全なインターフェース部品を記述させる方法。
目標
- 1回の実行のAG-UIイベントストリームを最後まで見ます。未完了
- フロントエンドツールを通じて返金を確定します。未完了
- A2UIのカタログにない部品を差し込み、拒否されるのを確かめます。未完了
- 確認問題に合格します。未完了
ステップ1/4: 本文
AG-UI:ストリームとしてのエージェントの作業
MCPはエージェントをツールに、A2Aはほかのエージェントにつなぎます。AG-UI(Agent–User Interaction protocol)は、エージェントを人が使うアプリにつなぎます。アプリはRunAgentInput(スレッドid、実行id、メッセージ、状態、アプリが提供するツール)を送り、イベントのストリームを読み返します。ここではserver-sent eventsです。
実行はRUN_STARTEDで始まり、RUN_FINISHEDかRUN_ERRORで終わります。テキストはTEXT_MESSAGE_START、続いてTEXT_MESSAGE_CONTENTの断片、最後にTEXT_MESSAGE_ENDとして届きます。ツール呼び出しも同じように届きます。TOOL_CALL_START、TOOL_CALL_ARGS、TOOL_CALL_END、そしてエージェントが実行したツールにはTOOL_CALL_RESULTです。共有状態は、状態全体であるSTATE_SNAPSHOTか、JSON Patch操作のリストであるSTATE_DELTAとして動きます。公式クライアントの@ag-ui/client 1.0.2は、各イベントを適用する前にそのスキーマと順序を確認します。
フロントエンドツール
確認ボタンや日付選択のように、アプリに属するツールもあります。アプリはそれをRunAgentInput.toolsに並べます。エージェントがそれを呼び出すと、実行はその呼び出しを保留にしたまま終わります。アプリがツールを実行し(ここでは顧客に尋ねます)、結果をツールメッセージとして次の実行を始めます。人の答えは会話の一部になり、それをどう扱うかはエージェントが決めます。
A2UI:データとしてのインターフェース
A2UI(プロトコルv0.9)を使うと、エージェントはコードを送らずにインターフェースの一部を記述できます。createSurfaceはサーフェスを開き、使うカタログを指定します。updateComponentsは、idで互いを参照する部品のフラットなリストを送ります。updateDataModelは、部品が結びつく値を送ります。アプリは自分のカタログにある部品だけを描画します。ここではCard、Column、Row、List、Text、Button、Dividerの7種類です。厳格な検証では、@a2ui/web_core 0.12.0は未知の型を拒否し、サーフェスは元のままです。そのため、エージェントも、エージェントをだましたプロンプトも、アプリに新しいコードを実行させることはできません。
ここですること
顧客がサポートチャットで二重請求について尋ねます。AG-UIでイベントのストリームを見て、アプリが描くカードで返金を確定してください。次にラボをA2UIに切り替えると、エージェントがメッセージから返金カードを組み立てます。「傍受」をオンにし、updateComponentsメッセージを保留してScript部品を追加します:web_coreがそれを拒否します。
ステップ2/4: 試す:エージェントが画面を組み立てる
エージェントが画面を組み立てる
4つのステップがあり、それぞれ操作は1つで、任意のステップが2つ続きます。ステップの下のラボは、すべてのメッセージを上から下へ1行ずつ描きます。A2UIのラボが開いている間は、ラボの下のツリーに、エージェントが送った部品がidでつながって表示されます。
モード:本物シミュレーション本物:AG-UIのクライアントとコア(@ag-ui/clientと@ag-ui/core 1.0.2)とA2UIのコアライブラリ(@a2ui/web_core 0.12.0)が、このページで動き、2つのワークフローではMCPとA2AのSDKも動きます。シミュレーション:モデルをつながない限り、エージェントの判断は台本どおりで、店と注文は架空です。
ステップ3/4: 確認問題
確認問題
次:質問2/4
ステップ4/4: これでできること
これでできること
- AG-UIのイベントストリームを読み、各イベントが何をするかを説明できます。
- フロントエンドツールを使って、エージェントの実行の中に人を入れられます。
- A2UIのサーフェス(createSurface、updateComponents、updateDataModel)を説明できます。
- A2UIのカタログが、エージェントが作るUIからアプリを守る仕組みを説明できます。