MINARA

実行中のターンへ指示を追加

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 として返ります。クライアントは通常のメッセージとして再送します。

目次