返回首页

对比阅读

对比阅读:When AI Agents Break, Engineers Blame the Instructions, Not the Model 与 AI 智能体出问题时,工程师开始追问的不再是模型 — 是它被喂了什么

AEN
Pi v0.82.1Agent frameworkcontext engineering·

When AI Agents Break, Engineers Blame the Instructions, Not the Model

Developers have reverse-engineered the "context loading manifest" of the open-source agent framework Pi v0.82.1. Our read: the real engineering debt of the Agent era isn't in model inference — it's in "which rules we told it, in what order, and how trustworthy they are."

What this is

Before an AI agent (Cursor, Devin, or an enterprise's internal Coding Agent) executes a task, developers typically leave several "instruction files" in the project: AGENTS.md for project rules, SYSTEM.md for modifying the base prompt, and SKILL.md for describing a specific capability (think of it as a "tool manual" given to the AI — read in full only when a task triggers it).

Pi treats these as a "versionable collection of resources" rather than a single ever-growing string. Four things matter: which files get loaded, in what order, who has execution permissions, and who calls a halt on conflict.

Industry view

Mainstream engineering communities (including OpenAI's and Anthropic's iterations on agent toolchains) default to "the more instructions the better." This piece takes the opposite view. It breaks down three forms of "context pollution": low-frequency content hogging permanent slots (Token Pollution), multi-layer instructions fighting each other (Instruction Conflict), and rules that are expired but stated with confidence (Stale Context). The third is the most dangerous — the model won't actively question whether an old command is still valid.

Proponents argue the framework should keep "project-level executable resources" separate from "untrusted text" and govern them differently. Critics counter that this kind of layered audit almost never lands in enterprises — most companies haven't even drawn the line on who has write access to AGENTS.md. The more grounded critique: treating a trust prompt as a full sandbox conflates prompt injection risk with code execution risk.

Impact on regular people

For enterprise IT: Teams evaluating or building in-house AI coding tools are starting to add "context audit capability" to their procurement checklists — specifically, which rule files were actually loaded for a given task and what their version numbers are.

For individual professionals: When an AI coding assistant produces code that mysteriously doesn't run, the common explanation isn't that the model got dumber — it's that some old rule in the project is still in effect. Next time you debug, ask: "Which instructions did it actually read?"

For the consumer market: As Agent engineering standards mature, enterprise-grade AI tools will see visible stability gains — but procurement costs and compliance barriers will rise in parallel.

来源: juejin.cn
BZH
Pi v0.82.1Agent 框架上下文工程·

AI 智能体出问题时,工程师开始追问的不再是模型 — 是它被喂了什么

开源智能体框架 Pi v0.82.1 最近被开发者拆出了它的「上下文加载清单」。我们读完的判断是:Agent 时代真正的工程债,不在模型推理,而在「我到底告诉了它哪些规则、以什么顺序、可不可信」。

这是什么

当 AI 智能体(如 Cursor、Devin 或企业内部 Coding Agent)执行任务前,开发者通常会在项目里留几份「指令文件」:AGENTS.md 写项目规则、SYSTEM.md 改基础提示、SKILL.md 描述某项专项能力(首次出现说明:相当于给 AI 配一张「工具说明书」,任务触发时才读取全文)。

Pi 把这些当作「可版本化的资源集合」来管理,而非一坨不断增长的字符串。重点是四件事:加载哪些文件、按什么顺序、谁有执行权限、冲突时由谁叫停。

行业怎么看

主流工程社区(包括 OpenAI 与 Anthropic 在 Agent 工具链上的迭代)默认「指令越多越好」,但本文视角相反。它拆出三种「上下文污染」:低频内容常驻挤占位置(Token Pollution)、多层指令互相打架(Instruction Conflict)、规则已过期但语气确定(Stale Context)。最危险的是第三条——模型不会主动怀疑一条旧命令是否仍然有效。

正方声音认为,框架应当把「项目级可执行资源」与「不可信文字」两件事分开管控;但反对意见指出,这种分层审计在企业里几乎落不了地——多数公司连「谁有权写 AGENTS.md」都没有划清边界。更现实的批评是:把弹个信任窗口当成完整沙箱,会把 Prompt 注入风险与代码执行风险混作一团。

对普通人的影响

对企业 IT:正在评估或自研 AI 编程工具的团队,开始把「上下文审计能力」列进采购清单——具体看本轮任务实际加载了哪些规则文件、版本号是什么。

对个人职场:当 AI 编程助手写出的代码「莫名跑不通」,常见解释不是模型变笨,而是项目里某份旧规则仍在生效;下次排错时,多问一句「它读到了哪些指令」。

对消费市场:随着 Agent 工程标准逐步成熟,企业级 AI 工具的稳定性会有可见改善,但采购成本与合规门槛也在同步抬升。

来源: juejin.cn