Zur Navigation springen

Konversationsnachricht senden

Alpha

Sendet Eingaben an eine Unterhaltung und wartet, bis der Agent fertig ist oder auf Ergebnisse von Client-Tools wartet. Wenn background auf true gesetzt ist, gibt der Endpunkt 202 zurück, sobald der Server den Turn annimmt. Streamen Sie dann die Events des Turns mit Last-Event-ID, gesetzt auf stream_cursor. Dieser Endpunkt befindet sich in der Alpha-Phase und kann sich ändern.

Pfadparameter

conversation_idstringErforderlich

Die Konversations-ID

Header

xi-api-keystringOptional

Anfrage

This endpoint expects an object.
inputlist of objectsErforderlich

Entweder eine user_message, die einen neuen Turn startet, oder client_tool_result-Elemente, die die required_actions des wartenden Turns beantworten und ihn fortsetzen. Nicht enthaltene Aufrufe bleiben ausstehend. Client-Tools warten ohne Zeitlimit. Solange Aufrufe ausstehen, wird eine user_message abgelehnt. Eine user_message kann contextual_update-Elemente enthalten, höchstens eines pro context_id. client_tool_result-Elemente, die jeden ausstehenden Aufruf beantworten, können end-Updates enthalten.

backgroundbooleanOptionalStandardwert ist false

Wenn true, wird nach Annahme des Turns ein 202-Handle zurückgegeben, statt auf den Abschluss der Generierung zu warten.

Antwort

Erfolgreiche Antwort
turn_idstring
statusenum
Erlaubte Werte:
outputlist of objectsOptional
errorobject or nullOptional
required_actionslist of objectsOptional

Die Aktionen, auf die der Agent wartet. Beantworten Sie jeden client_tool_call mit einem client_tool_result-Element in input, um fortzufahren.

stream_cursorstring or nullOptional

Fortsetzungs-Token für den Event-Stream dieses Turns. Es ist vorhanden, während der Turn läuft; übergeben Sie es als Last-Event-ID, um die Events des Turns zu streamen.

Fehler

422
Unprocessable Entity Error