连接插件
连接 Gmail、Notion、Slack 等服务,让 agents 能在聊天中使用这些服务。
什么是插件?
插件可让 agents 与外部服务通信。插件连接归属于你登录 Grok Bot 时使用的同一账户。
如何添加插件?
- 在 Grok Bot 中,选择侧边栏中的 插件,或按聊天中的 连接 卡片操作。在 Grok Bot 移动端应用中,轻点左上角的头像,然后选择 插件。
- 浏览或搜索插件,然后添加。
- 当 Grok Bot 要求你进行 授权 或 认证 时,请在浏览器中完成服务提供商的登录。
- 如果 Grok Bot 显示 等待授权,请使用 重新打开,以恢复浏览器标签页。
- 确认该插件显示在 已安装 下。
为什么插件显示“已被团队管理员禁用”?
如果你通过 Cherri Code 团队使用 Grok Bot,可用的 marketplace 插件由 Cherri Code 团队管理员控制。如果某个插件被禁用,请联系管理员启用该插件。
Cherri Code 中的这项控制与公司的 Google 管理员相互独立。若是 Google 侧的拦截,请使用下一节中的界面处理。
如果 Google 提示需要管理员评审 Grok 该怎么办?
企业 Google 账户可能会在 Gmail、Calendar、Drive、Docs、Sheets 或 Slides 完成登录前中断连接。Grok Bot 是以 Grok 而非 Cherri Code 的身份登录 Google 的。下一步取决于 Google 页面的提示。
你的管理员需要评审 Grok
Grok 尚未在该 Workspace 中获得批准。如果 Google 页面上有请求访问的按钮,请点击提交请求。等管理员批准 Grok 后,再次尝试 授权。
IT 管理员可在 Google Admin console 中批准 Grok:
- 打开 Security,再进入 Access and data control,然后是 API controls。
- 打开 App access control,然后是 Manage third-party app access。
- 添加名为 Grok 的应用。如果按名称搜索找不到,请使用被拦截页面或管理员评审邮件中的 client ID。
- 为使用 Grok Bot 的成员将 Grok 设为 Trusted。
该批准适用于这些成员连接的 Google 插件,但不会重新启用插件市场中的插件。那需要由 Cherri Code 团队管理员通过上文的 Disabled by team admin 控件来操作。
访问被拦截
Google 拒绝了此次登录。个人 Gmail 账户无需企业管理员批准。企业账户遇到这种情况,通常是因为 Grok 不在允许列表中,或者管理员已拦截第三方应用。
请按上述步骤,让 Google 管理员将 Grok 设为受信任应用。如果之后页面仍显示访问被拦截,请联系支持团队,并提供该 Google 账户的电子邮件地址以及被拦截页面的截图。更换浏览器或重新关联插件都无法解除 Google 管理员的拦截。
插件 能做什么?
插件 使用你授权的账户,只能执行该账户在对应服务中本来就能执行的操作。它无法提升你的访问权限,也无法更改共享设置。
Google Calendar
bot 可以读取你能查看的日历、创建和更新事件、查看空闲时间,并在你有编辑权限的日历上回复邀请。
它无法更改 Google Meet 设置,例如等候室或主持人控制项,也无法为事件添加 Zoom 链接。从 Calendar 网站添加的 Zoom 链接使用的是 Google 的 Zoom 附加组件,而 插件 无法使用该附加组件。你可以自行把 Zoom 链接写入事件的地点或描述中,或者先在 Calendar 中创建事件,再让 bot 更新其他字段。
Google Sheets
连接 Sheets 后,bot 可以读取并编辑所连 Google 账户有编辑权限的电子表格中的单元格。以"查看者"身份共享的文件仍为只读。插件 无法更改文件的访问权限人员。
查找和打开文件由 Google Drive 插件 负责。Drive 可以搜索并读取该账户能打开的文件。编辑单元格内容则由 Google Sheets 负责。
Slack
Slack 插件 以你连接的 Slack 用户身份发布消息,而不是以需要被邀请的独立 bot 身份发布。它只能在该用户有权发言的频道中发布消息,无法在该用户未加入的私有频道中发布,也无法在该工作区禁止发言的频道中发布。若要使用其他 Slack 工作区,请连接该工作区。这与触发例程的 Slack 消息是两回事,参见例程。
Gmail
Gmail 可以在所连邮箱中搜索和阅读邮件、起草和发送邮件,以及应用标签。
可以连接两个 Gmail 账户吗?
不可以。Gmail 一次只能连接一个邮箱。若要使用其他 Gmail 邮箱,请先断开当前邮箱的连接,再授权另一个邮箱。个人邮箱和工作邮箱无法同时连接到 Gmail。
已安装的 插件 对该 Grok Bot 账户下的每个 bot 都可用。如果某个 bot 不应使用该邮箱,请断开 Gmail 的连接。
其他一些插件 (例如 Notion) 可以连接第二个账户。请参阅如何为同一插件添加第二个账户?
插件已添加,但 Bot 提示缺少该插件,该怎么办?
已添加仅表示插件已安装,并不代表你已登录。打开该插件,如果显示需要认证或已断开连接,请选择授权。如果连接卡片始终未出现或点击后无反应,请参阅如何重新连接插件?
为什么连接 Zoom 时会在授权过程中出现错误 4700?
这是一个已知问题,我们的工程师正在修复。通过 Grok Bot 桌面端应用授权 Zoom 目前会失败,并显示错误 4700 (重定向无效) ;您无法通过任何操作解决此问题。
目前暂无临时解决方案。Zoom 恢复可连接后,我们会更新本文。