ActSpace Docs
上下文管线
了解系统规则、历史、工具、附件、缓存与压缩如何组成模型真正看到的 Context。
在 ActSpace 中,Context 是运行时产物,不是一段散落在代码里的字符串。每次模型调用前,系统都会按稳定顺序组合规则、会话历史、工具定义和当前输入。
Context 的主要来源
- 主 Agent 系统提示词与当前人格配置。
- 仓库级
AGENTS.md和关联项目规则。 - 已持久化的用户、助手、工具与审批事件。
- 当前可见工具的 schema。
- 附件、图片和工具产生的多模态 observation。
- Kairos 或 SubAgent 的专属运行上下文。
Context 查看器使用与真实 Turn 相同的规则加载链路,目的是避免“界面显示一套、模型实际收到另一套”。
稳定排序与缓存
更稳定、复用频率更高的内容应尽量靠前;当前 Turn 的易变输入靠后。这样能提升支持 prompt caching 的服务商命中率,并降低长任务成本。
Usage 页面会记录 input、output、cache read 与总 Token,并按统一口径估算费用。
工具可见性
工具并不总是一次性全部塞入 Context。以 Browser 为例,每个新 Turn 默认只暴露入口工具;模型明确需要浏览器能力后,再从下一次请求开始披露完整工具组。
这种 progressive disclosure 同时减少 Token 和误调用。
压缩
当历史接近模型上下文窗口时,ActSpace 会对旧内容执行压缩。压缩需要保留:
- 用户目标和已经确认的约束。
- 已完成工作的事实与关键文件路径。
- 失败原因和未解决风险。
- 工具结果中影响后续判断的证据。
工具长输出也会单独裁剪或摘要,但应保留原始输出前缀与关键细节,避免只留下失真的概括。
用户可以在会话中使用 /compact 主动触发压缩,并看到开始、进度和完成状态。
Context 状态
每个会话维护可恢复的 Context 状态和快照。它们用于查看当前组成、排查缓存或 Token 异常,以及在评估模式下对比每次模型调用前的输入。
如果你正在排查某个工具为什么出现或消失,下一步阅读工具与审批和Browser Use。