Skip to main content
集成将 Mintlify agent 与团队已在使用的工具连接起来。Agent 可以在 Slack 中回复或运行自动化时使用已连接的应用。某些共享集成中的事件还可以启动自定义自动化。
Mintlify Slack 应用与本页中的第三方集成相互独立。安装 Slack 应用会将 agent 添加到工作区，并让 agent 和自动化运行访问该应用获准读取的 Slack 内容。你不需要在 Integrations 中连接 Slack，也不需要在自动化的 Tools 中选择它，但在安装 Slack 应用后，你可以将其选为自定义自动化的触发器。

​
连接范围

  • 共享集成只需为整个组织连接一次。Slack agent 可以使用这些集成；你可以将其添加为自动化工具；如果集成提供事件，还可以用它触发自定义自动化。
  • 个人集成由每位团队成员单独连接。Slack agent 使用正在与其对话的团队成员的个人账户。个人集成不能作为工具或触发器添加到自动化。
例如，如果两位团队成员分别连接不同的 Google Drive 账户，他们在 Slack 中向 agent 提问时，只会获得各自 Drive 中的结果。 可以连接个人账户的团队成员数量没有限制。在有多位参与者的 Slack 线程中，agent 会使用每条消息发送者的个人集成。

​
连接集成

管理员和编辑者可以为组织连接共享集成。每位团队成员连接自己的个人集成。

​
从控制台连接

  1. 前往设置中的 Integrations 页面。
  2. 找到集成并点击 Connect。
  3. 完成授权流程。
配置自动化时，你也可以在 Tools 中选择尚未连接的应用，并直接完成授权。

​
从 Slack agent 连接

让 agent 连接某个应用，例如“连接我的 Google Drive”。完成 agent 在线程中返回的授权链接，然后在同一线程中再次发送消息，让 agent 确认并使用该连接。

​
支持的集成

控制台会显示当前可供你组织使用的集成。某些集成可能会逐步发布。 Pylon 是一个用于客户支持的共享只读集成。你可以使用它搜索支持工单，并检索工单消息、账户、联系人或用户信息。在 Integrations 页面连接 Pylon。然后在 Slack agent 中使用它，或在自动化的 Tools 设置中选择它。

​
在 Slack agent 中使用集成

安装 Mintlify Slack 应用后，agent 可以在回答问题或更新文档时使用集成。你不需要为每次 Slack 对话选择集成。 Agent 可以使用：
  • 已为组织连接的共享集成。
  • 发送请求的团队成员所连接的个人集成。
  • Mintlify 应用获准读取的 Slack 频道和线程。
Agent 仅在集成数据与请求相关时访问这些数据。

​
将集成用作自动化工具

自动化工具会在自动化启动后为 agent 提供额外上下文。只能选择共享集成。
  1. 打开自动化设置。
  2. 在 Tools 中选择该自动化可以使用的集成。
  3. 连接任何尚未连接的已选集成。
  4. 保存自动化。
用作触发器的集成会自动添加为该自动化的工具，以便 agent 在收到事件后检索更多详细信息。

​
通过集成触发自动化

  1. 创建或打开自定义自动化。
  2. 在 Trigger 中选择 Integration。
  3. 选择或连接一个共享集成，或选择 Slack。
  4. 选择 Trigger event，并填写出现的其他事件字段。
  5. 保存并启用自动化。
每个自动化只能有一个触发器。选择 Integration 会替代内容更新、代码变更或自定义计划触发器。 事件发生时，Mintlify 会启动自动化，并将事件数据作为 agent 的上下文。

​
Slack 频道消息触发器

将 Slack 选为触发器集成，可在有人在你选择的频道中发布新消息时运行自定义自动化。需要安装 Mintlify Slack 应用，并已将其添加到你选择的每个频道。
  • 仅所选频道中的顶层消息会启动运行。会忽略线程回复以及提及 Mintlify agent 的消息。
  • Agent 会将消息文本、频道、发送者和永久链接作为上下文，然后判断该消息是否值得采取某种操作，例如更新文档。并非每条消息都会产生变更。
  • 你可以在一个自动化中选择多个频道。每个频道必须是公开频道，或是已添加 Mintlify 应用的私有频道。

​
权限与访问

Agent 可用的第三方集成工具均为只读。Agent 可以搜索和检索内容，但不能使用这些工具在已连接的应用中创建、编辑或删除数据。 Agent 会继承授权连接的账户所拥有的访问权限。若要缩小访问范围，请限制该账户的权限，或只向 Mintlify 应用开放特定资源。连接应用之前，请在授权页面查看具体权限。

​
断开集成

  1. 前往 Integrations 页面。
  2. 点击该集成的 Configure。
  3. 点击 Disable integration。
断开共享集成会为整个组织移除该集成，并停止将其用作触发器的自动化接收新事件。断开个人集成只会移除你自己的连接。

​
排查连接问题

确认授权账户仍可访问相关内容，然后断开并重新连接集成，再次完成授权。如果该连接供 Slack agent 使用，请在原始 Slack 线程中再次发送消息。如果授权被阻止，请让应用或工作区管理员批准 Mintlify。