Erklärung des Begriffs: Agent User Interaction Protocol (AG-UI)

Begriff Agent User Interaction Protocol
Abkürzung AG-UI
Eintrag zuletzt aktualisiert am 11.09.2026

Zur Stichwortliste unseres Lexikons

Was ist Agent User Interaction Protocol ?

AG-UI standardisiert die ereignisbasierte Kommunikation zwischen Agent und Benutzeroberfläche (z.B. Webanwendung).

Typische Szenarien:
  • Fortschrittsanzeigen
  • Streaming-Ausgaben
  • Formulareingaben
  • Genehmigungen
  • Tool-Aufrufe
  • Rückfragen
AG-UI ist keine Spezifikation für das Layout oder die Beschreibung einer generierten Oberfläche. Dafür lassen sich beispielsweise A2UI, Open-JSON-UI oder MCP-UI verwenden. AG-UI bildet die bidirektionale Laufzeitverbindung, über die solche UI-Inhalte, Statusänderungen und Interaktionen transportiert werden können.

AG-UI arbeitet technisch als ereignisorientierter Stream zwischen Frontend und Agenten-Backend. Anders als bei einem klassischen REST-Aufruf übermittelt der Agent nicht erst am Ende ein einzelnes Resultat, sondern während der Ausführung eine Folge typisierter JSON-Ereignisse.

Protokolle

  • HTTP mit Server-Sent Events (SSE): Dies ist der Standard
  • WebSocket: Wenn während eines Laufs viele Nachrichten vom Client zum Agenten erforderlich sind.
  • Webhooks / Push-Benachrichtigungen: Wenn Frontend und Agent nicht dauerhaft verbunden sind oder ein Lauf Minuten bis Stunden dauern kann.
  • Binäres HTTP-Protokoll: Infrastruktur- oder Hochlastfall; für eine normale Agenten-UI zunächst unnötig.
  • Eigener Transport: AG-UI definiert primär das Ereignismodell und kann grundsätzlich auch über weitere Transportkanäle getragen werden
Das Datenformat ist JSON.

Ursprung

AG-UI ist kein Standard eines großen KI-Anbieters wie Google oder Anthropic, sondern entstand aus der Open-Source-Agentic-UI-Bewegung. Ziel ist eine standardisierte Darstellung von Agentenaktivitäten in Web- und Desktop-Oberflächen.

Beispiel

Anfrage:

POST /agent HTTP/1.1
Content-Type: application/json
Accept: text/event-stream
Authorization: Bearer <Token>

{
"threadId": "chat-4711",
"runId": "run-001",
"messages": [
{
"id": "msg-user-1",
"role": "user",
"content": "Erstelle eine Umsatzanalyse."
}
],
"state": {
"period": "2026-Q3"
}
}

Antwort:

data: {"type":"RUN_STARTED","threadId":"chat-4711","runId":"run-001"}
data: {"type":"TEXTMESSAGESTART","messageId":"msg-agent-1","role":"assistant"}
data: {"type":"TEXTMESSAGECONTENT","messageId":"msg-agent-1","delta":"Die Analyse "}
data: {"type":"TEXTMESSAGECONTENT","messageId":"msg-agent-1","delta":"ist abgeschlossen."}
data: {"type":"TEXTMESSAGEEND","messageId":"msg-agent-1"}
data: {"type":"RUN_FINISHED","threadId":"chat-4711","runId":"run-001"}

Beratung & Support

Schulungen

Anfrage für eine individuelle Schulung zum Thema AGENT USER INTERACTION PROTOCOL AG-UI Gesamter Schulungsthemenkatalog