Compact 模式

Compact 解决什么问题，出错时怎么选

Compact 用于处理长会话中的上下文压缩请求。这是管理员后台的上游 OpenAI 账号设置，不在普通用户的 API 密钥页面；日常保持 Auto，只有验证兼容性或隔离故障时才临时强制开启或关闭。

返回文档首页打开 1A1API 控制台查看错误码排查

管理员路径

在哪里设置和探测 Compact

需要管理员权限。普通用户遇到 compact 报错时应保留日志并联系管理员，不要在 API 密钥页面寻找这个开关。

单个账号设置管理后台 → 账号管理 → OpenAI 账号 → 编辑 → Compact 模式。同一区域可以设置 Compact 专属模型映射。

能力探测管理后台 → 账号管理 → OpenAI 账号 → 更多 → 测试连接 → 测试模式：Compact 探测。完成后可在账号列表查看支持状态与最近探测时间。

批量修改账号管理 → 选中 OpenAI 账号 → 批量编辑账号 → Compact 模式。只对符合条件的 OpenAI 账号显示。

不要把 Force On 当作普通用户的故障修复按钮。它不能补充模型权限、余额或错误 Base URL；管理员应先做 Compact 探测并核对调用日志。

先理解

长对话接近客户端或模型的上下文限制时，兼容客户端可能发送 /responses/compact 请求，把较早内容压缩成更短的上下文。该设置控制账号是否参与这类请求，不会扩大模型本身的最大上下文窗口。

什么时候可能触发长时间 Agent 任务、连续多轮对话、反复附带大量日志或文件时。

用户会看到什么多数情况下由客户端自动处理；只有失败时，才可能看到 compact 相关报错或长会话突然中断。

先查哪里先看调用日志里是否出现 compact 相关请求、状态码和报错原文，再决定是否切换模式。

模式选择

自动（Auto） 跟随该上游账号的 Compact 探测结果；尚未探测时，后端仍允许账号参与。日常使用保持此项。

强制开启（Force On） 临时强制允许该账号参与 compact，只用于已确认需要的兼容性验证。

强制关闭（Force Off） 临时排除该账号，用于判断故障是否由 compact 请求触发。

模型映射 只影响 compact 请求。没有明确的服务端配置要求时不要填写。

不知道该选什么就保持 Auto。Force On / Force Off 都应是临时排查状态，验证结束后恢复 Auto。

排查顺序

记录工具、模型 ID、时间和报错全文，不要只截取“失败”两个字。

确认请求是否到达 1A1API，以及失败的是普通 Responses 请求还是 compact 请求。

新开会话发送一句最小测试。短请求成功、长会话失败时，再检查上下文长度和 compact。

临时切换 Force Off 做对照；不要同时换模型、地址、密钥和模式，否则无法定位原因。

Force On 不能修复模型权限、余额、错误 Base URL 或客户端不支持的问题。401、403、404 应先按对应状态码排查。