向正在运行的轮次追加指令
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 返回;客户端应将其作为普通消息重新发送。