壓縮對話上下文
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,並保留原上下文。手動和自動壓縮共用這兩項檢查。