上下文指针是一份文档中指向另一份文档的提示,使智能体只在任务需要时才把目标内容加载进上下文窗口。它是构成渐进式披露的基本单元。
使用指针而不直接内联内容,原因在于成本。指针在上下文窗口中只占一行;它背后的文档可能包含数千个 Token,但在智能体真正沿指针读取前,这些 Token 不会产生任何成本。如果把一份 2,000 Token 的操作手册直接写进 AGENTS.md,每次会话都要为它付费;如果改成“部署流程:参阅 internal/deploy.md”,则只有执行部署任务的会话才会加载它。当任务匹配时,智能体通过一次工具调用沿着指针读取内容。
一个有效指针需要两部分:稳定路径,以及足够清晰的说明,让智能体知道何时值得沿指针读取。只有路径的指针没有提供任何读取理由;如果只写“参阅 internal/deploy.md”,却不说明其中内容,即使会话真正需要它也可能跳过。应让描述与任务出现的方式相匹配,例如:“发布、部署或回滚——先阅读 internal/deploy.md”。
一旦开始留意,就会发现上下文指针无处不在:AGENTS.md 中的说明行、技能描述(运行框架先加载描述,技能正文则在其后等待按需读取)、目录列表中的文件名,以及文档之间的链接。
指针还可以把二手来源关联回它所依据的一手来源,例如压缩摘要中注明原始对话记录,或文档中标出自己描述的源文件。这样,二手来源造成的信息损失就可以恢复:当摘要不够用时,智能体能够沿指针读取原始材料,而不是只能依赖摘要保留下来的部分继续工作。
避免:称为“reference(引用)”——过于静态,无法表达沿指针会加载更多上下文;也不要称为“portal(传送门)”——过于夸张。
用法:
“AGENTS.md 变得越来越大了。”
“其中大部分应该是上下文指针,而不是正文。只把始终生效的规则内联;把部署手册和样式指南做成技能,在 AGENTS.md 中留下对应的上下文指针。”