Ir para a navegação

Obter turno da conversa

Alpha

Obtenha o status e a saída de um turno. O status vem da transcrição armazenada, portanto, um turno que falhou após o agente iniciar pode aparecer como concluído. Somente o evento stream_ended apresenta o resultado real. Este endpoint está em alfa e pode mudar.

Parâmetros de caminho

conversation_idstringObrigatório
O ID da conversa
turn_idstringObrigatório
O ID do turno

Cabeçalhos

xi-api-keystringOpcional

Resposta

Resposta bem-sucedida

turn_idstring
statusenum
Valores permitidos:
outputlist of objectsOpcional
errorobjectOpcional
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_cursorstringOpcional

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
Conversations Get Turn Request Unprocessable Entity Error