MengBotDocs
已连接的应用

已连接应用

为机器人提供安全、经用户授权的工具,覆盖 Gmail、GitHub、Slack、Notion 以及数百种其他服务。

从侧边栏打开 已连接应用,选择一个服务,并在你常用的浏览器中完成其授权。MengBot 会将由此建立的连接转换为受支持的智能体引擎可使用的工具。

简洁的 MengBot 已连接应用市场
在市场中进行搜索,或从“已连接”标签页查看所有账号。

官方打包应用

已签名的桌面应用会向 MengBot 托管的已连接应用服务注册自己的安装。你无需查找或粘贴 Composio 密钥。

  1. 打开 已连接应用。
  2. 搜索 Gmail、GitHub、Slack、Notion 或其他工具包。
  3. 选择 连接。
  4. 在打开的浏览器窗口中完成 OAuth。
  5. 返回应用,让机器人使用该服务。

安装身份使用 Electron 由操作系统支持的安全存储进行保存。提供方的 OAuth 令牌保留在 Composio 中,不会写入机器人提示词或渲染进程。

MengBot Cloud

已连接应用随 MengBot Cloud 套餐提供。每个 Cloud 在启动时都会向同一托管服务注册自己的安装,因此无需添加密钥:在 Cloud 上打开 已连接应用,按上述方式连接应用即可。该安装会随该 Cloud 在重启后保留,且绝不会被复制到备份中。

自托管或源码构建

托管服务是为官方打包构建提供的便利。源码构建可以使用你自己的 Composio 项目和 COMPOSIO_API_KEY;参见自托管 Composio。

你也可以在打包应用或 Cloud 上使用自己的 Composio 项目。打开 应用设置 → 连接 → 自托管已连接应用,粘贴其项目密钥。已保存的项目密钥在应用市场、连接管理和机器人工具方面优先于托管服务。清除密钥即可返回托管服务。

连接 X(Twitter)

要让机器人搜索和读取 X,你不需要 X 账号或 Composio 连接。打开 应用,找到 X(Twitter) 卡片:

  • 在付费 MengBot Cloud 套餐上,卡片会显示 已包含在你的套餐中,并显示本月用量(“本月已使用 312 次 X 调用,共 5,000 次”)。无需任何设置。Starter 套餐每月 500 次调用,Personal 为 1,500 次,Pro 为 5,000 次,Max 为 15,000 次,并在每月 1 日重置。用完后,卡片和你的机器人会说明这一点以及重置时间。
  • 其他所有人需在卡片上粘贴自己的 treg 密钥(与 设置 → API 密钥 下的密钥相同)。卡片会用 treg 校验该密钥,并显示你的余额或具体问题。测试会再次校验,移除密钥会将其删除。调用会计入你的 treg 余额,MengBot 不设限制。
  • 两者都有时,会优先使用你自己的密钥,卡片也会说明这一点。移除后,你的机器人会回到套餐包含的调用额度。

随后每个机器人都会获得 Research (treg):用于搜索帖子、读取账号帖子、读取帖子及其回复和查询个人资料的只读工具,以及用于查找并调用 treg 目录中公司、人物、融资、新闻等内容的调研工具。既没有密钥也没有套餐时,不会向任何机器人显示这些工具。可在某个机器人的设置中的 访问权限 下为其关闭这些工具。该机器人上的例程可以按计划检查 X,并仅报告新帖子。在 Cloud 上,你的密钥保留在 Cloud 自己的设置中:机器人通过 MengBot 调用 X,永远不会看到密钥。

以下步骤仅在通过 Composio 发布到 X 时需要。Composio 不为其 twitter 工具包提供托管凭据。要连接 X 账号:

  1. 在 X 开发者门户中创建一个应用。
  2. 使用该应用的凭据在你的 Composio 项目中创建一个 twitter 认证配置。
  3. 在 自托管已连接应用 下保存该项目的密钥。
  4. 返回 已连接应用 并连接 X(Twitter)。

官方托管的 MengBot 服务在拥有合适的 X OAuth 应用之前会保持 X 禁用。将连接器称为 x 的旧 MengBot 任务仍可继续工作;MengBot 会自动将该别名转换为 Composio 的 twitter 工具包。

需要你自己的 OAuth 应用的应用

某些应用(例如 Xero 和 Buffer)没有 Composio 提供的登录方式,因此只能通过你自己的 OAuth 应用连接:

  1. 在你的 Composio 项目中,为该应用创建认证配置(认证配置 → 创建),填入你 OAuth 应用的客户端 ID 和密钥,并保持启用。
  2. 在 自托管已连接应用 下保存该项目的密钥。
  3. 从 已连接应用 连接该应用,或让机器人在聊天中请求连接。

MengBot 会自行找到认证配置,在使用前开启 Composio 所需的功能(“为 Tool Router 启用”,你自己创建的配置可能处于关闭状态),并告知机器人它使用了哪个配置。如果同一应用有多个配置,它会使用最近创建的那个。你在 Composio 仪表板本身建立的连接对 MengBot 不可见,因此请从 MengBot 连接一次该应用。

使用托管服务时,这些应用无法连接:它使用 MengBot 自己的 Composio 项目,而该项目无法使用你的 OAuth 应用。请按上述方式添加你自己的项目密钥。

多个账号

为同一工具包连接多个账号,并为每个账号设置清晰的别名,例如 work、personal 或 client-acme。当多个账号都可能执行某项操作时,MengBot 会要求明确选择,而不是静默替换第一个连接。

限制机器人可使用的工具

连接服务会使其工具在工作区中可用;这并不会把每个工具都交给每个机器人。在桌面端打开机器人的设置,在 已连接应用 下按服务选择该机器人获得 所有工具、精确列表 中的工具,还是 无工具。

默认情况下,每个机器人对其可见的应用保留所有工具——在你分配授权之前,升级或连接新应用都不会改变这一点。一旦机器人拥有任何授权,其列表中缺失的服务就不会授予它任何内容。导入的机器人和可共享包始终以无授权状态落地。

手机在机器人资料的 应用工具 下以只读方式显示每个机器人的授权。编辑在电脑上进行;配对的手机永远无法更改授权。

断开连接

断开账号会撤销上游授权。它不只是在本机 UI 中隐藏账号。同一工具包的其他账号仍保持连接。

无需 Connect 密钥

当前的官方构建会自动配置已连接应用。只有当你刻意自行运行该集成时,才需要 Composio 项目密钥。

On this page