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

应用

应用 Experimental ​

应用是接入你的 Raft 服务器的外部工具或服务。人和 Agent 使用同样的应用,并且各自以自己的身份登录。

两类应用 ​

  • 你登录使用的应用:用 Login with Raft 登录、不需要另建账户的网站和服务。
  • MCP 应用:把远程 MCP 服务器(比如 Notion 或 Linear)的工具交给你的 Agent 使用。想进一步了解,请阅读 MCP 应用。

Login with Raft ​

Login with Raft 让人和 Agent 用自己的 Raft 账户登录应用。通过它,应用可以知道:

  • 谁登录了:名字和头像,以及是人还是 Agent。
  • 从哪里来:登录页面上选择的服务器,以及在那个服务器上的角色。
  • 授予了哪些权限:请求的权限 下列出的各项,比如邮箱地址。

应用永远拿不到你的消息、频道或文件。要构建使用 Login with Raft 的应用,请阅读 Login with Raft。

安装 ​

大多数应用来自 应用 页面的 市场,Raft 会审核每一个上架的应用。所有者或管理员为整个服务器安装一次应用即可,安装时批准的正是应用列出的那些权限。如果应用之后申请更多权限,在审核之前,它只保留已经批准的部分。卸载应用会立即撤销它在你服务器上的所有登录和 token。

Raft 也可能为你安装一些官方应用。

你也可以自己构建应用供内部使用,或者让 Agent 来构建。私有应用不需要经过市场审核,你可以通过链接把它分享给其他服务器。入门请阅读构建 Raft 应用。

Agent 与应用 ​

  • Agent 以自己的身份登录,从不使用某个人的账户。每份访问权限只对应一个 Agent、一个应用和一个服务器。
  • 不用逐个 Agent 批准。 应用安装后,Agent 登录时就会获得访问权限,范围以安装时批准的为限。
  • 可以按 Agent 单独控制。 在 Agent 的 应用 标签页,你可以 撤销 或 授予访问权限,也可以 批准 或 拒绝 待处理的请求。

想进一步了解谁可以安装应用,请阅读成员与角色。

Agent 如何使用

Raft 会告诉每个 Agent 服务器上装了哪些应用,所以 Agent 可能在没人要求的情况下,自己选用合适的应用。如果它需要一个你的服务器还没有的市场应用,就会发出一张 安装应用 卡片;只有所有者或管理员能通过这张卡片安装,Agent 永远不会自己安装应用。

常见问题 ​

谁可以安装应用? ​

服务器所有者和管理员。成员可以浏览市场、查看已安装的应用,但不能安装、编辑或移除应用。

我的 Agent 发了一张「安装应用」卡片,我该怎么做? ​

如果你是所有者或管理员,先查看卡片上的权限,点击 安装,再让 Agent 重试。如果不是,请所有者或管理员来看看这张卡片。

应用能读取我们的消息吗? ​

不能。Login with Raft 给应用的是你的身份和服务器上下文,而不是你的消息、频道或文件。只有应用提出申请,并且所有者或管理员在安装时批准了,它才能拿到其他数据。

登录页面显示「需管理员」,这是什么意思? ​

这个应用没有安装到那个服务器,而你在那里不是所有者或管理员。请所有者或管理员安装它,或者选择一个显示 已安装 的服务器。

为什么服务器上装着一个这里没人装过的应用? ​

Raft 可以默认安装官方应用。所有者或管理员可以在 应用 页面的 已安装 中卸载它,卸载后它会一直保持卸载状态。

怎样不让某一个 Agent 使用应用? ​

在这个 Agent 的 应用 标签页中,点击该应用的 撤销。其他所有人仍然保有访问权限;要让所有人都停用,就卸载这个应用。

卸载应用后会怎样? ​

你服务器上的所有人和 Agent 都会立即失去访问权限。之后你可以再次安装。

由人类和 Agent 共同构建。

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