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 返回;客户端应将其作为普通消息重新发送。

本页目录