怎样在正确时刻,把正确资料交给模型?
Context Engineering(上下文工程)是持续决定模型这一刻应该看到什么、按什么顺序看到,以及信息超限时保留和舍弃什么。
教学案例:Agent 搜到三个 timeout 文件,其中一个是已经废弃的示例。若系统只按关键词排名,它可能认真修改一份根本不会运行的代码。
上下文工程用人话说,就是在每一步替模型准备正确材料。系统先给项目地图和规则,再按当前问题读取实现、测试与最近错误;同时保留文件路径、版本和选择理由,方便回头核对。
同一个模型在两个产品里表现不同,常常不是 Prompt 长短不同,而是一个拿到了正确项目事实,另一个被旧文件和噪声带偏。
Agent 每一步都依赖 Harness 构造的新输入。高质量上下文需要渐进披露:先给稳定地图,再按任务读取细节;让信息可检索、可验证、不过期。
候选资料怎样进入本轮输入包?
同一个登录超时任务,现行代码与测试优先于旧 README;每份材料都要检查权限、权威性、时效、相关性和预算,冲突不能静默合并。
- 当前代码与测试
- 项目规则
- 旧 README
- 搜索结果
- 上一轮工具回执
- 1有权限只读已授权仓库
- 2来源更权威当前代码和测试优先
- 3仍然有效旧 README 标记过期
- 4与当前步骤相关只选 timeout 路径
- 5放得进预算全文保留位置,按需重读
若规则冲突,显式呈现并等待选择,不替用户偷偷合并。
先给地图,再按问题读取细节
项目说明、允许修改的目录和完成标准可以先进入工作台;相关实现、测试和错误日志再按当前假设读取。每份材料保留路径和版本,结论才能回到原文件。
敏感凭证、无关目录和外部内容里的可疑指令不应因为“搜索相关”就进入普通上下文。
搜索命中不等于应该使用
文件名包含 timeout,只说明文字相关,不证明它属于当前运行路径。系统还要比较导入关系、测试引用和最近修改,并在冲突时展示差异或继续查证。
来自 Issue、README 和网页的文字首先是任务材料,不能因为它声称“忽略原规则”就获得更高指令权。
回到登录超时任务看一次选择错误
教学项目里,示例目录和真实实现都包含 timeout。只看关键词时,示例排在前面;加入导入关系和测试引用后,系统发现真实调用落在 auth/session.ts,并把示例降为补充材料。
修复点不在“让模型更认真”,而在材料选择规则:当前运行路径优先、测试引用优先、废弃目录默认排除,仍有冲突就让用户看见。
把材料分成常驻、按需和禁入
登录超时任务的常驻层放目标、项目规则和完成标准;按需层放实现文件、测试和日志;禁入层放密钥、项目外文件和未经授权的网络内容。
常驻规则改动要评审,按需材料要记录为什么被选中,禁入内容由确定性边界拦截。这样“给模型看什么”才是可维护的产品设计。
实现对照 · DeepSeek Harness
材料越来越多,怎样继续而不丢掉依据?
压缩过程记录开始、摘要或替换范围与结束。模型看到的是经过投影的有效上下文,日志继续保留相关事实。这样可以研究一次信息取舍怎样影响后续工作,而不是把历史无痕删短。
产品判断:同时检查上下文大小、证据召回、关键约束和最终结果。
固定源码观察 · 核验 2026-09-11。业务迁移为本站分析。
本课术语,放回情境理解
- Context Engineering
- 持续选择、组织、压缩、更新和治理模型当前可见信息的系统工作。
- 渐进披露
- 先提供稳定地图和索引,再根据当前任务按需读取细节。
- Scope
- 信息生效的范围,例如用户、团队、项目、任务或单次调用。
- TTL
- 信息在多长时间后需要过期或重新确认。
- 上下文污染
- 无关、过期、冲突或不可信信息进入模型并影响判断。
本课依据与证据边界
正文引用对应下面的具体结论。厂商资料、固定版本实现与本站解释分别标识。
- [1]
OpenAI 的 Harness Engineering 案例强调为 Agent 提供可导航、可验证的仓库信息和反馈环境。
官方事实OPHarness engineering: agent-first world官方工程文章 · 核验 2026-07-14 - [2]
Codex Agent Loop 的公开说明包含上下文组装、工具结果回填与长任务压缩。
官方事实OPUnrolling the Codex agent loop官方工程文章 · 核验 2026-07-14 - [3]
本站的 Context Pipeline 七步与 always/on-demand/never 分层是通用教学框架。
本站推演OPHarness engineering: agent-first world官方工程文章 · 核验 2026-07-14 - [4]
登录超时项目中的废弃示例与真实实现冲突为本站教学案例,不对应任何真实仓库事故。
本站推演OPHarness engineering: agent-first world官方工程文章 · 核验 2026-07-14 - [5]
常驻、按需、禁入三层是本站为产品学习者整理的上下文治理方法。
本站推演OPUnrolling the Codex agent loop官方工程文章 · 核验 2026-07-14
按需查阅的原始材料
- How Claude Code works ↗Anthropic · 核验 2026-07-23
- Effective context engineering for AI agents ↗Anthropic · 核验 2026-07-23
- How Claude remembers your project ↗Anthropic · 核验 2026-07-23
- Create custom subagents ↗Anthropic · 核验 2026-07-23
- Effective harnesses for long-running agents ↗Anthropic · 核验 2026-07-23
- Unrolling the Codex agent loop ↗OpenAI · 核验 2026-07-23
- Harness engineering: leveraging Codex in an agent-first world ↗OpenAI · 核验 2026-07-23
- Hermes Agent context compression and tool runtime ↗Nous Research · 核验 2026-07-23
- Harnessing Claude’s intelligence ↗Claude by Anthropic · 核验 2026-07-23
- Hermes Agent Persistent Memory ↗Nous Research · 核验 2026-07-14
- Hermes Agent Context Compression and Caching ↗Nous Research · 核验 2026-07-14