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