탐색으로 건너뛰기

대화 메시지 전송

Alpha

대화에 입력을 전송하고 에이전트가 완료하거나 클라이언트 도구 결과를 기다릴 때까지 대기합니다. background를 true로 설정하면 서버가 턴을 수락할 때 엔드포인트가 202를 반환합니다. 그런 다음 Last-Event-ID를 stream_cursor로 설정해 턴의 이벤트를 스트리밍하세요. 이 엔드포인트는 알파 단계이며 변경될 수 있습니다.

경로 매개변수

conversation_idstring필수

대화 ID

헤더

xi-api-keystring선택 사항

요청

This endpoint expects an object.
inputlist of objects필수

새 턴을 시작하는 user_message 하나 또는 대기 중인 턴의 required_actions에 응답하고 이를 계속 진행하는 client_tool_result 항목을 지정합니다. 제외된 호출은 보류 상태로 유지됩니다. 클라이언트 도구는 시간 제한 없이 대기합니다. 호출이 보류 중인 동안 user_message는 거부됩니다. user_message에는 context_id당 최대 하나의 contextual_update 항목을 포함할 수 있습니다. 보류 중인 모든 호출에 응답하는 client_tool_result 항목에는 end 업데이트를 포함할 수 있습니다.

backgroundboolean선택 사항기본값 false

true이면 생성이 완료될 때까지 기다리지 않고 턴이 허용된 후 202 핸들을 반환합니다.

응답

성공 응답

turn_idstring
statusenum
허용된 값:
outputlist of objects선택 사항
errorobject선택 사항
required_actionslist of objects선택 사항

에이전트가 대기 중인 작업입니다. 계속하려면 각 client_tool_call에 대해 input의 client_tool_result 항목으로 응답하세요.

stream_cursorstring선택 사항

이 턴의 이벤트 스트림을 재개하기 위한 토큰입니다. 턴이 진행 중인 동안 제공되며, 턴의 이벤트를 스트리밍하려면 Last-Event-ID로 전달하세요.

오류

422
Conversations Send Message Request Unprocessable Entity Error