MINARA

压缩对话上下文

POST /v1/sessions/:id/compact. 压缩对话上下文

POST /v1/sessions/:id/compact

立即将全部已完成的对话历史整理成摘要,只有一轮对话时同样可用。手动压缩没有轮数门槛,会合并已有摘要与新增历史。用户原话在上下文预算内保留,原始聊天记录保持不变。自动压缩沿用原有触发条件和近期内容保留策略。

方法POST
路径/v1/sessions/:id/compact
认证设置 GATEWAY_AUTH_TOKEN 后须携带 Authorization: Bearer <token>
分类sessions

响应内容

{ "messagesSummarized": 12, "toolCallsSummarized": 2 }

说明

计数为零时,skipped: "empty" 表示空会话,skipped: "unchanged" 表示上次压缩后没有新增消息。会话不存在返回 404,分支任务返回 400,会话忙碌返回 409。摘要生成或保存失败返回 500,并保留之前的摘要。新对话轮次会等待压缩完成。

不足 512 tokens 的可替换内容返回 skipped: too_small,不请求模型。计入保留的用户原话和摘要标记后,摘要节省不足 128 tokens 时返回 skipped: no_savings,并保留原上下文。手动和自动压缩共用这两项检查。

本页目录