実行中のターンへ指示を追加
POST /v1/chat/interject:セッションで進行中のターン向けに誘導メッセージをキューに入れます。ゲートウェイは次のステップ境界で現在のターンへ注入します。
POST /v1/chat/interject
セッションで進行中のターン向けに誘導メッセージをキューに入れます。ゲートウェイは次のステップ境界で実行中のターンへ注入し、モデルは新しいターンを開始せずに現在の作業へ組み込みます。ライブの /v1/chat/stream 接続は、注入を user_interjection イベント({ message, ts_ms })としてエコーします。
| メソッド | POST |
| パス | /v1/chat/interject |
| 認証 | GATEWAY_AUTH_TOKEN 設定時は Authorization: Bearer <token> が必要 |
| カテゴリ | chat |
リクエスト本文
{ "session_id": "sess_abc", "message": "skip the 1h chart, focus on funding rates" }レスポンス本文
{ "status": "injected" }注記
長いターンがまだストリーミング中にユーザーが追加入力し、そのメッセージで進行中の作業を誘導したい場合(範囲を狭める、制約を追加する、誤った前提を正す)に使用します。中断するためのものではありません。
レスポンス:実行中のターンにメッセージをキュー入れできた場合は 200 と { "status": "injected" }、セッションでターンが実行されていない場合は 409 と { "status": "no_active_turn" } を返します。後者ではクライアントは通常の POST /v1/chat/stream リクエストとしてメッセージを送信します。session_id または message がないか空の場合は 400 です。
キューに入ったものの注入には遅すぎたメッセージは、ストリーム最後の done イベントで pending_interjections として返ります。クライアントは通常のメッセージとして再送します。