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_idmessage 時返回 400

已排隊但到達過晚、無法注入的消息會在流最終的 done 事件中以 pending_interjections 返回;客戶端應將其作為普通消息重新發送。

本頁目錄