대화 메시지 전송
대화에 입력을 전송하고 에이전트가 완료하거나 클라이언트 도구 결과를 기다릴 때까지 대기합니다. background를 true로 설정하면 서버가 턴을 수락할 때 엔드포인트가 202를 반환합니다. 그런 다음 Last-Event-ID를 stream_cursor로 설정해 턴의 이벤트를 스트리밍하세요. 이 엔드포인트는 알파 단계이며 변경될 수 있습니다.
경로 매개변수
conversation_id
대화 ID
헤더
xi-api-key
요청
This endpoint expects an object.
input
새 턴을 시작하는 user_message 하나 또는 대기 중인 턴의 required_actions에 응답하고 이를 계속 진행하는 client_tool_result 항목을 지정합니다. 제외된 호출은 보류 상태로 유지됩니다. 클라이언트 도구는 시간 제한 없이 대기합니다. 호출이 보류 중인 동안 user_message는 거부됩니다. user_message에는 context_id당 최대 하나의 contextual_update 항목을 포함할 수 있습니다. 보류 중인 모든 호출에 응답하는 client_tool_result 항목에는 end 업데이트를 포함할 수 있습니다.
background
true이면 생성이 완료될 때까지 기다리지 않고 턴이 허용된 후 202 핸들을 반환합니다.
응답
성공 응답
turn_id
status
허용된 값:
output
error
required_actions
에이전트가 대기 중인 작업입니다. 계속하려면 각 client_tool_call에 대해 input의 client_tool_result 항목으로 응답하세요.
stream_cursor
이 턴의 이벤트 스트림을 재개하기 위한 토큰입니다. 턴이 진행 중인 동안 제공되며, 턴의 이벤트를 스트리밍하려면 Last-Event-ID로 전달하세요.
오류
422
Conversations Send Message Request Unprocessable Entity Error