Hoppa till navigering

Skicka konversationsmeddelande

Alpha

Skicka indata till en konversation och vänta tills agenten slutför eller väntar på resultat från klientverktyg. När background är true returnerar slutpunkten 202 när servern godkänner turen. Strömma sedan turens händelser med Last-Event-ID inställt på stream_cursor. Den här slutpunkten är i alfa och kan ändras.

Sökvägsparametrar

conversation_idstringObligatorisk

Konversations-ID:t

Headers

xi-api-keystringValfri

Förfrågan

This endpoint expects an object.
inputlist of objectsObligatorisk

Antingen ett user_message, som startar en ny tur, eller client_tool_result-objekt som besvarar required_actions för den väntande turen och fortsätter den. Anrop som utelämnas förblir väntande. Klientverktyg väntar utan tidsgräns. Medan anrop väntar avvisas ett user_message. Ett user_message kan innehålla contextual_update-objekt, högst ett per context_id. client_tool_result-objekt som besvarar alla väntande anrop kan innehålla end-uppdateringar.

backgroundbooleanValfriStandard är false
If true, return a 202 handle after the turn is admitted instead of waiting for generation to finish.

Svar

Lyckat svar
turn_idstring
statusenum
Tillåtna värden:
outputlist of objectsValfri
errorobjectValfri
required_actionslist of objectsValfri

Åtgärderna som agenten väntar på. Besvara varje client_tool_call med ett client_tool_result-objekt i input för att fortsätta.

stream_cursorstringValfri

Återupptagningstoken för den här turens händelseström. Finns medan turen pågår; skicka den som Last-Event-ID för att strömma turens händelser.

Fel

422
Conversations Send Message Request Unprocessable Entity Error