Ir para a navegação

Enviar mensagem da conversa

Alpha

Envia uma entrada para uma conversa e aguarda até que o agente termine ou espere resultados de ferramentas do cliente. Com background definido como true, o endpoint retorna 202 quando o servidor aceita o turno. Em seguida, transmita os eventos do turno com Last-Event-ID definido como stream_cursor. Este endpoint está em alfa e pode mudar.

Parâmetros de caminho

conversation_idstringObrigatório
O ID da conversa

Cabeçalhos

xi-api-keystringOpcional

Solicitação

This endpoint expects an object.
inputlist of objectsObrigatório

Um único user_message, que inicia um novo turno, ou itens client_tool_result, que respondem às required_actions do turno em espera e o continuam. As chamadas que forem omitidas permanecem pendentes. As ferramentas do cliente aguardam sem tempo limite. Enquanto houver chamadas pendentes, um user_message será rejeitado. Um user_message pode incluir itens contextual_update, no máximo um por context_id. Itens client_tool_result que respondem a todas as chamadas pendentes podem incluir atualizações end.

backgroundbooleanOpcionalPadrão é false

Se true, retorna um identificador 202 após o turno ser aceito, em vez de aguardar a geração ser concluída.

Resposta

Resposta bem-sucedida

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

As ações que o agente aguarda. Responda a cada client_tool_call com um item client_tool_result em input para continuar.

stream_cursorstring or nullOpcional

Token de retomada para o fluxo de eventos deste turno. Está presente enquanto o turno está em andamento; passe-o como Last-Event-ID para transmitir os eventos do turno.

Erros

422
Unprocessable Entity Error