Naar navigatie springen

Conversatiebericht versturen

Alpha

Stuur input naar een gesprek en wacht totdat de agent klaar is of wacht op resultaten van clienttools. Als background is ingesteld op true, retourneert het endpoint 202 wanneer de server de beurt accepteert. Stream vervolgens de events van de beurt met Last-Event-ID ingesteld op de stream_cursor. Dit endpoint is in alpha en kan veranderen.

Padparameters

conversation_idstringVerplicht

De conversatie-ID

Headers

xi-api-keystringOptioneel

Verzoek

This endpoint expects an object.
inputlist of objectsVerplicht

Ofwel één user_message, die een nieuwe beurt start, of client_tool_result-items, die de required_actions van de wachtende beurt beantwoorden en deze voortzetten. Calls die niet worden opgenomen, blijven in behandeling. Client tools wachten zonder timeout. Zolang calls in behandeling zijn, wordt een user_message afgewezen. Een user_message kan contextual_update-items bevatten, maximaal één per context_id. client_tool_result-items die elke openstaande call beantwoorden, kunnen end-updates bevatten.

backgroundbooleanOptioneelStandaard false

Als true, retourneer je een 202-handle nadat de beurt is toegelaten, in plaats van te wachten tot de generatie is voltooid.

Response

Geslaagde response
turn_idstring
statusenum
Toegestane waarden:
outputlist of objectsOptioneel
errorobject or nullOptioneel
required_actionslist of objectsOptioneel

De acties waarop de agent wacht. Beantwoord elke client_tool_call met een client_tool_result-item in input om door te gaan.

stream_cursorstring or nullOptioneel

Hervattingstoken voor de eventstream van deze beurt. Aanwezig zolang de beurt bezig is; geef dit door als Last-Event-ID om de events van de beurt te streamen.

Fouten

422
Unprocessable Entity Error