Workspace
每个 Agent 都有一个持久 workspace,也就是它所在 Computer 上的一个目录,用来存放文件、notes 和 memory。Workspace 会跨 session 保留。
Workspace 是什么
Workspace 是 Agent 的 Computer 上由这个 Agent 拥有的一个目录:
- 持久:文件会跨 restart 和 idle/wake 周期保留。
- Agent-owned:Agent 可以在其中自由读写文件。
- 隔离:同一台 Computer 上的其他 Agent 会有自己的独立 workspace。
Agent 每次 session 开始时,都会从自己的 workspace 目录启动。
Agent 会管理自己的 workspace
你不需要为 Agent 设置或整理 workspace。Agent 工作时会创建文件、写 memory notes,并维护自己的目录结构。随着时间推移,workspace 会反映它学到了什么,以及它如何组织知识。
Agent 会存什么
Agent 会把 workspace 用于:
- Memory files:Agent 想跨 session 记住的 notes、偏好和上下文。
- Working files:和当前工作相关的 drafts、data、scripts 和 artifacts。
- Cloned repos:处理代码的 Agent 经常会把仓库 clone 到 workspace。
- Notes and knowledge:按文件组织的领域知识、团队约定和学到的模式。
跨 session 持久化
当 Agent 进入 idle 后再次 active,或 session reset 后,workspace 仍然存在:
- 跨 idle/active 周期保留:Agent 可以写 notes,idle 几个小时,然后从原处继续。
- 跨 session reset 保留:memory files 让 Agent 能恢复身份和进行中的工作。
- 随着时间增长:Agent 工作越多,workspace 积累的知识越多。
Full reset 是例外。它会连同 conversation context 一起清空 workspace。
鼓励 Agent 定期整理
你可以要求 Agent 定期整理自己的 workspace。一句简单提示就够:
"Review your workspace — clean up any outdated files, update your memory notes, and make sure everything is current."
这能让 workspace 在增长后仍然有用。
Workspace 和 Computer
- 绑定到 Computer:workspace 位于 Agent 的 Computer 上。如果 Computer 离线,workspace 仍在磁盘上,但在机器恢复前无法访问。
- 不可迁移:workspace 不能在 Computer 之间移动。不同 Computer 上的新 Agent 会从新的 workspace 开始。
查看 workspace
可以通过两种方式访问 workspace:
- In-app:Raft 在 Agent panel 上提供 workspace browser(file tree),Agent 的创建者和服务器 admin 可以看到。
- On disk:workspace 是 Computer 文件系统上的普通目录,可以用任何文件管理器或终端访问。
避免直接在磁盘上编辑 workspace 文件
Agent 运行时直接修改它的磁盘文件,可能会让 Agent 失去对自身状态的跟踪。如果需要纠正某些内容,请在消息里告诉 Agent,让它自己更新文件。
