环境

环境是智能体实际操作的世界：位于运行框架之外、智能体通过工具结果感知并通过工具调用改变的一切。运行框架负责运行智能体，环境则是智能体开展工作的地方。AGENTS.md 之类的文件存在于环境中，运行框架负责把它加载进上下文窗口。文件系统是最常见的环境，但并非唯一形式；数据库、远程 API 和浏览器会话都可以成为环境。

智能体只有在主动查看时才能看到环境。它对环境的全部认知都来自工具结果，因此脑中的图景其实是一组快照，每张快照只在获取的那个时刻准确。如果文件在智能体读取后发生变化——例如你手动编辑，或构建步骤重新生成——智能体仍会依据旧副本推理，直到某个操作促使它重新读取。智能体信心十足地描述一个早已变样的文件，通常就是因为环境已经变化，而快照没有更新。

环境也是负责持久化的层级——唯一始终有状态的一层。会话结束后，其中的上下文会消失；写入环境的文件却会保留下来，供下次会话读取。记忆系统、交接产物和 AGENTS.md 都依赖这一点。凡是智能体明天仍需知道的内容，最终都必须进入环境。

环境的范围由你决定。沙箱会缩小环境，限制智能体能够触达的内容；添加工具则会扩展环境，把数据库或 API 纳入可操作范围。边界以内是智能体能够感知和改变的世界，边界以外对它而言并不存在。环境对智能体工作的支持程度，就是代码库的 AX。

避免：用“环境”指代运行时或运行框架本身。运行框架是外层包装，环境才是工作空间。

用法：

“智能体看不到预发布数据库的 schema。”

“把数据库接入环境：提供一个仅能只读访问预发布环境的 psql 工具。运行框架本身没有问题，只是目前没有可供它操作的对象。”