ナビゲーションにスキップ

会話メッセージを送信

Alpha

会話に入力を送信し、エージェントが完了するか、クライアントツールの結果待ちになるまで待機します。backgroundをtrueに設定すると、サーバーがターンを受け付けた時点でエンドポイントは202を返します。その後、Last-Event-IDをstream_cursorに設定してターンのイベントをストリーミングします。このエンドポイントはアルファ版であり、変更される可能性があります。

パスパラメータ

conversation_idstring必須

会話ID

ヘッダー

xi-api-keystringオプション

リクエスト

This endpoint expects an object.
inputlist of objects必須

新しいターンを開始する1件のuser_message、または待機中のターンのrequired_actionsに応答してターンを続行するclient_tool_result項目のいずれかです。含まれていない呼び出しは保留のままになります。クライアントツールの待機にはタイムアウトがありません。呼び出しが保留中の場合、user_messageは拒否されます。user_messageには、context_idごとに最大1件の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