Saltar a la navegación

Enviar mensaje de conversación

Alpha

Envía una entrada a una conversación y espera hasta que el agente termine o espere los resultados de herramientas del cliente. Con background establecido en true, la ruta de API devuelve 202 cuando el servidor admite el turno. Después, transmite los eventos del turno con Last-Event-ID establecido en stream_cursor. Esta ruta de API está en fase alfa y puede cambiar.

Parámetros de ruta

conversation_idstringRequerido

El ID de la conversación

Encabezados

xi-api-keystringOpcional

Solicitud

This endpoint expects an object.
inputlist of objectsRequerido

Un único user_message, que inicia un nuevo turno, o elementos client_tool_result, que responden a las required_actions del turno en espera y lo continúan. Las llamadas que se omitan permanecerán pendientes. Las herramientas de cliente esperan sin tiempo de espera. Mientras haya llamadas pendientes, se rechazará un user_message. Un user_message puede incluir elementos contextual_update, como máximo uno por context_id. Los elementos client_tool_result que respondan a todas las llamadas pendientes pueden incluir actualizaciones end.

backgroundbooleanOpcionalValor predeterminado: false

Si es true, devuelve un identificador 202 después de aceptar el turno, en lugar de esperar a que termine la generación.

Respuesta

Respuesta correcta.
turn_idstring
statusenum
Valores permitidos:
outputlist of objectsOpcional
errorobject or nullOpcional
required_actionslist of objectsOpcional

Acciones que el agente está esperando. Responde a cada client_tool_call con un elemento client_tool_result en input para continuar.

stream_cursorstring or nullOpcional

Token de reanudación para el flujo de eventos de este turno. Está presente mientras el turno está en curso; pásalo como Last-Event-ID para transmitir los eventos del turno.

Errores

422
Unprocessable Entity Error