Agent User Interaction Protocol (AG-UI)
Eintrag zuletzt aktualisiert am: 11.09.2026
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.
UrsprungAG-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.
BeispielAnfrage:
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"}