会話メッセージを送信
会話に入力を送信し、エージェントが完了するか、クライアントツールの結果待ちになるまで待機します。backgroundをtrueに設定すると、サーバーがターンを受け付けた時点でエンドポイントは202を返します。その後、Last-Event-IDをstream_cursorに設定してターンのイベントをストリーミングします。このエンドポイントはアルファ版であり、変更される可能性があります。
パスパラメータ
conversation_id
会話ID
ヘッダー
xi-api-key
リクエスト
This endpoint expects an object.
input
新しいターンを開始する1件のuser_message、または待機中のターンのrequired_actionsに応答してターンを続行するclient_tool_result項目のいずれかです。含まれていない呼び出しは保留のままになります。クライアントツールの待機にはタイムアウトがありません。呼び出しが保留中の場合、user_messageは拒否されます。user_messageには、context_idごとに最大1件の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
Unprocessable Entity Error