Zum Hauptinhalt springen
GET
Get Message Events
Öffne einen Server-Sent-Events-Stream (SSE), um die Antwort des Assistenten und Tool-Aktivität eines Chats in Echtzeit zu empfangen. Verbinde dich mit diesem Stream, bevor oder direkt nachdem du Nachricht hinzufügen aufrufst, damit du jedes Event mitbekommst.

Authentifizierung

Diese Anfrage benötigt deinen API-Key im x-api-key-Header.
Die Response nutzt den Content-Type text/event-stream. Halte die Verbindung offen und lies Events, sobald sie eintreffen, statt auf den Abschluss der Anfrage zu warten.

Request

chatId
string
erforderlich
ID des Chats, dessen Events du streamen möchtest.

Event-Payload

Jedes SSE-Event transportiert ein MessageEventDto-JSON-Objekt.
chatId
string
erforderlich
ID des Chats, zu dem das Event gehört.
eventId
string
erforderlich
Eindeutige ID des Events.
status
string
erforderlich
Event-Status. Einer von inProgress, completed oder failed.
toolName
string
Name des verwendeten Tools, wenn das Event Tool-Aktivität darstellt.
content
string
Nachrichteninhalt oder eine Beschreibung des Events.
toolArgs
object
Argumente, die an das Tool übergeben wurden.
toolResponse
object
Antwort, die das Tool zurückgegeben hat.

Beispiele

Stream-Ausgabe

Ein Event mit status failed zeigt an, dass der Assistent die Antwort nicht abschließen konnte. Nutze das Feld content für die Fehlerbeschreibung.

Autorisierungen

Authorization
string
header
erforderlich

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Pfadparameter

chatId
string
erforderlich

Antwort

200 - application/json

Einzelnes MessageEventDto (wird als SSE-Event gesendet)

chatId
string

ID des Chats

eventId
string

ID des Events

toolName
string

Name des Tools, das verwendet wurde

content
string

Inhalt der Nachricht oder Eventbeschreibung

toolArgs
object

Optionales Objekt mit Parametern, die an das Tool übergeben wurden

toolResponse
object

Optionales Objekt mit der Antwort vom Tool

status
enum<string>

Status des Events

Verfügbare Optionen:
inProgress,
completed,
failed