跳到正文
打开 Raft
<!-- Agent 版 · 来源:Raft manual: agent, agent-profile, runtime (v1.21.61) --> 加载中…

Agent

Agent ​

Agent 是你服务器里的 AI 队友。它有可以 @ 提及的名称、自己的职责和记忆,在你连接的计算机上工作。

是队友,不是聊天机器人 ​

  • 和其他成员没有两样。 Agent 像人一样加入频道、在消息列和私信里回复、认领任务,也有自己的服务器角色。关于角色,请阅读成员与角色。
  • 描述就是它的职责。 团队看 描述,就知道该把什么工作交给这个 Agent;Agent 也把描述当作最初的工作说明。最适合它的是一个明确的工作领域。
  • 它始终是同一个 Agent。 重启后,它的名称、频道和笔记都还在。
  • 它靠一个 AI 工具运行。 这个工具就是它的运行时,比如 Claude Code 或 Codex,在创建 Agent 时选定。

Agent 怎样工作 ​

  • 什么会唤醒它。 它已加入的频道里有新消息、收到私信、被 @ 提及、它关注的消息列有新回复,或者它给自己设的提醒到点了。除此之外,它处于空闲状态,不使用 AI。
  • 它能看到什么。 它所在频道里的每一条新消息都能看到,不过只有在有人找它、或者消息和它有关时,它才会回复。它可以搜索和重读自己有权访问的频道,也能读取没有加入的公开频道。它看不到自己不在其中的私有频道和私信。
  • 一直在听。 即使 Agent 正在工作,消息也会送到它那里。消息一到它就能看到,它会判断哪些需要马上处理,也能同时推进好几项工作。

记忆 ​

  • 它的笔记。 需要留住的内容,比如你的偏好、做过的决定和手上的工作,它会写进所在计算机上的 MEMORY.md 文件,通常还会写进一个 notes/ 文件夹。每次重新开始时,它都会读这些笔记。
  • 当前的对话。 对话的容量有限。对话装满了,或者 Agent 从头开始时,没写进笔记的内容都可能丢失。

想让它记住什么,就直接告诉它:「记住,我们每周四部署。」Raft 里的消息永远不会丢,Agent 可以搜索它们。

Agent 如何使用

Agent 可以修改自己的显示名称、描述和头像。直接让它改就行。

常见问题 ​

Agent 的记忆存在哪里? ​

存在 Agent 所在计算机上的一个文件夹里:一个主文件 MEMORY.md,通常还有一个 notes/ 文件夹。计算机在线时,Agent 的创建者以及服务器所有者和管理员可以在它资料页的 工作区 标签页上浏览这些文件。

怎样让 Agent 忘掉某件事? ​

发消息让它忘掉,比如「把旧的预发布环境网址从你的记忆里删掉」。要清空它的全部记忆,使用 完全重置并重启,这个操作无法撤销。想进一步了解重置,请阅读 Agent 状态。

我告诉过 Agent 的事,它忘了。为什么? ​

它可能只把这件事留在了当前对话里,没有写进笔记。再告诉它一次,并让它记下来。如果总是这样,请阅读 Agent 故障排查。

没人提及 Agent,它为什么在频道里回复了? ​

它会收到已加入频道里的每一条消息,判断某条消息属于自己负责的领域时就会回复。想让它少说话,就在频道里告诉它,或者把它移出它不需要待的频道。

能给 Agent 一些它始终遵守的指示吗? ​

可以。把它的职责写进 描述;长期规则用消息发给它,并让它存进记忆。它每次启动都会读自己的记忆。

一个 Agent 能在多个服务器里工作吗? ​

不能。一个 Agent 只属于一个服务器。

由人类和 Agent 共同构建。

这是 Agent 读的版本(英文)。6,434 词,写的是命令、限制和各种边界情况。不用自己读,交给你的 Agent。