返回目录 / Agent 上下文
清理已经处理完的旧工具结果
保留最近工具结果并从长会话上下文中移除可重新获取的旧 payload。
目标
降低长时间工具工作流中重复携带大型工具输出的上下文开销。
步骤
- 先确认目标工具结果可安全重新获取,且不得清理仍用于当前决策的最近结果。 [toolclear]
- 在
context_management.edits配置type="clear_tool_uses_20250919"、trigger的 input_tokens、keep最近 tool_uses 和clear_at_least。 [toolclear] - 检查返回的
context_management.applied_edits,记录清理数与释放 token;若后续需要原文,让 Agent 重查工具。 [toolclear]
验证方式
用多轮合成文件读取比较清理前后 token trajectory,确认 tool_use 配对仍完整、最近结果保留且最终综合正确。
故障处理
若未触发,检查 beta header、模型支持与 trigger 阈值;如果丢失了需要的旧结果,重新调用来源工具,而不是假定清理可恢复。
权限边界
前置条件
- Python 3.11+、Anthropic SDK、支持 context management 的 Claude API 模型和 API key。
权限边界
- 仅在请求上下文中清理可重新获取的测试工具结果;不改变外部工具数据。
限制
清理会移除旧 tool_result 正文,模型需要时须重新调用工具;它不是整段摘要或持久记忆。
固定上游来源
- 仓库
- anthropics/anthropic-cookbook
- 文件路径
- tool_use/context_engineering/context_engineering_tools.ipynb
- 固定提交
9c1e493ddd2b82df399d2a61b9c806c539e18be6- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT