POST /sessions/{sid}/interrupt
中断当前正在执行的 Run。
POST /cells/{cellID}/sessions/{sid}/interrupt
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
cellID | string | Cell ID |
sid | string | 会话 ID |
请求体
无。不需要请求体。
curl 示例
curl -s -X POST "http://localhost:9091/cells/dept-legal/sessions/ses-a1b2c3d4/interrupt" \
-H "Authorization: Bearer $TOKEN" | jq .
响应
200 OK
{
"ok": true
}
幂等语义:如果该会话当前没有活跃的 Run,仍然返回 200。重复调用是安全的。
注意事项
- Run 收到中断信号后会尽快停止,但不保证立即终止(当前工具调用可能会执行完毕)。
- 中断后,引擎会执行 CognitiveSettlement(认知结算),保存会话状态。
- SSE 流会收到
interrupted终端事件。 - 中断后的 Run 不可恢复,需要发起新的 Run。
错误码
| HTTP | 错误 | 说明 |
|---|---|---|
| 401 | — | 未认证或 Token 无效 |
| 403 | — | 无权操作该会话 |
| 404 | — | Cell 或会话不存在 |
相关端点
- POST /run — 发起 Run
- GET /sessions/{sid}/messages — 获取会话消息
- DELETE /sessions/{sid} — 删除会话