Zum Inhalt springen
Zurück zu Agentensysteme und Standards

Agentensysteme und Standards · Kapitel 3 von 8

Agenten und Oberflächen: AG-UI und A2UI

Die Arbeit eines Agenten mit AG-UI an eine App streamen und einen Agenten mit A2UI sichere Oberflächenkomponenten beschreiben lassen.

25 Minuten0 von 4 Zielen erreicht

Ziele

  • Verfolge den AG-UI-Event-Stream eines Laufs bis zum Ende.Offen
  • Bestätige die Erstattung über ein Frontend-Tool.Offen
  • Schleus eine Komponente außerhalb des A2UI-Katalogs ein und sieh, wie sie abgelehnt wird.Offen
  • Besteh den Check.Offen

Schritt 1 von 4: Der Text

AG-UI: die Arbeit des Agenten als Stream

MCP verbindet einen Agenten mit Tools und A2A mit anderen Agenten. AG-UI (Agent–User Interaction Protocol) verbindet ihn mit der App, die ein Mensch nutzt. Die App sendet einen RunAgentInput (Thread-ID, Run-ID, Nachrichten, State und die Tools, die die App anbietet) und liest einen Stream von Events zurück, hier als Server-Sent Events.

Ein Lauf beginnt mit RUN_STARTED und endet mit RUN_FINISHED oder RUN_ERROR. Text kommt als TEXT_MESSAGE_START, dann als Fragmente in TEXT_MESSAGE_CONTENT, dann TEXT_MESSAGE_END. Tool-Calls kommen genauso: TOOL_CALL_START, TOOL_CALL_ARGS, TOOL_CALL_END und TOOL_CALL_RESULT für Tools, die der Agent ausgeführt hat. Gemeinsamer State wandert als STATE_SNAPSHOT, der ganze State, oder als STATE_DELTA, eine Liste von JSON-Patch-Operationen. Der offizielle Client, @ag-ui/client 1.0.2, prüft Schema und Reihenfolge jedes Events, bevor er es anwendet.

Frontend-Tools

Manche Tools gehören der App: ein Bestätigungsbutton, ein Datumswähler. Die App listet sie in RunAgentInput.tools. Ruft der Agent eines auf, endet der Lauf mit diesem Aufruf als offen; die App führt das Tool aus, hier indem sie den Kunden fragt, und startet den nächsten Lauf mit dem Ergebnis als Tool-Nachricht. Die Antwort des Menschen wird Teil der Unterhaltung, und der Agent entscheidet, was er damit macht.

A2UI: Oberflächen als Daten

A2UI (Protokoll v0.9) lässt einen Agenten ein Stück Oberfläche beschreiben, ohne Code zu senden. createSurface öffnet eine Surface und nennt den Katalog, den sie nutzt; updateComponents sendet eine flache Liste von Komponenten, die per ID aufeinander verweisen; updateDataModel sendet die Werte, an die sie gebunden sind. Die App rendert nur Komponenten aus ihrem eigenen Katalog, hier sieben Typen: Card, Column, Row, List, Text, Button und Divider. Mit strikter Validierung lehnt @a2ui/web_core 0.12.0 einen unbekannten Typ ab und die Surface bleibt, wie sie war, also kann ein Agent, oder ein Prompt, der ihn getäuscht hat, die App keinen neuen Code ausführen lassen.

Was du hier machst

Ein Kunde fragt den Support-Chat nach der doppelten Abbuchung. Über AG-UI siehst du dir den Event-Stream an und bestätigst dann die Erstattung auf der Card, die die App zeichnet. Danach stellst du das Lab auf A2UI um, wo der Agent aus Nachrichten eine Erstattungs-Card baut. Schalte Abfangen ein, halte die Nachricht updateComponents an und füg eine Script-Komponente hinzu: web_core lehnt sie ab.

Schritt 2 von 4: Probier es aus: Ein Agent baut einen Bildschirm

Ein Agent baut einen Bildschirm

Vier Schritte mit je einer Aktion, dann zwei optionale. Das Lab unter den Schritten zeichnet jede Nachricht als Zeile, von oben nach unten. Solange ein A2UI-Lab offen ist, zeigt ein Baum unter dem Lab die Komponenten, die der Agent geschickt hat, über ihre id verbunden.

Modus:EchtSimuliertEcht: Client und Core von AG-UI (@ag-ui/client und @ag-ui/core 1.0.2) und die Core-Bibliothek von A2UI (@a2ui/web_core 0.12.0) laufen auf dieser Seite, mit den SDKs von MCP und A2A in den zwei Workflows. Simuliert: Die Entscheidungen des Agenten sind geskriptet, außer du verbindest ein Modell, und der Shop und die Bestellung sind erfunden.

Schritt 3 von 4: Check

Check

Frage 1 von 4Was ist ein Frontend-Tool in AG-UI?

Als Nächstes: Frage 2 von 4

Frage 2 von 4Warum rendert A2UI aus einem Katalog, statt das Markup des Agenten auszuführen?
Frage 3 von 4Was trägt ein AG-UI-Event STATE_DELTA?
Frage 4 von 4Der Client empfängt TEXT_MESSAGE_CONTENT für eine messageId, die nie ein TEXT_MESSAGE_START hatte. Was passiert?

Schritt 4 von 4: Was du jetzt kannst

Was du jetzt kannst

  • Einen AG-UI-Event-Stream lesen und sagen, was jedes Event bewirkt.
  • Mit einem Frontend-Tool einen Menschen in den Lauf eines Agenten holen.
  • Eine A2UI-Surface beschreiben: createSurface, updateComponents und updateDataModel.
  • Erklären, wie der Katalog von A2UI eine App vor UI schützt, die ein Agent gebaut hat.