# 用于 agent 和自动化的集成 (/zh/automations/integrations)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1293 · updated: 2026-09-23 -->
Related: [创建自定义自动化](/zh/automations/create.md), [管理自动化](/zh/automations/manage.md), [预定义自动化](/zh/automations/reference.md)

集成将 Mintlify agent 与团队已在使用的工具连接起来。Agent 可以在 Slack 中回复或运行自动化时使用已连接的应用。某些共享集成中的事件还可以启动自定义自动化。

<Info>
  集成需要 [Enterprise 计划](https://mintlify.com/pricing?ref=automations)。
</Info>

| 使用场景            | 工作方式                                                            |
| --------------- | --------------------------------------------------------------- |
| **Slack agent** | 使用组织的共享集成，以及正在与 agent 对话的团队成员所连接的个人集成。                          |
| **自动化工具**       | 从自动化 **Advanced options** 下 **Integrations** 设置中选择的共享集成获取只读上下文。 |
| **自动化触发器**      | 当受支持的共享集成中发生所选事件时，或当在所选 Slack 频道中发布新的顶层消息时，启动自定义自动化。            |

<Note>
  [Mintlify Slack 应用](/zh/agent/slack)与本页中的第三方集成相互独立。安装 Slack 应用会将 agent 添加到工作区，并让 agent 和自动化运行访问该应用获准读取的 Slack 内容。你不需要在 **Integrations** 中连接 Slack，也不需要在自动化的 **Integrations** 字段中选择它，但在安装 Slack 应用后，你可以将其选为自定义自动化的触发器。
</Note>

<div id="connection-scope">
  ## 连接范围 [#连接范围]
</div>

* **共享集成**只需为整个组织连接一次。Slack agent 可以使用这些集成；你可以将其添加为自动化工具；如果集成提供事件，还可以用它触发自定义自动化。
* **个人集成**由每位团队成员单独连接。Slack agent 使用正在与其对话的团队成员的个人账户。个人集成不能作为工具或触发器添加到自动化。

例如，如果两位团队成员分别连接不同的 Google Drive 账户，他们在 Slack 中向 agent 提问时，只会获得各自 Drive 中的结果。

可以连接个人账户的团队成员数量没有限制。在有多位参与者的 Slack 线程中，agent 会使用每条消息发送者的个人集成。

<div id="connect-an-integration">
  ## 连接集成 [#连接集成]
</div>

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

<div id="from-the-dashboard">
  ### 从控制台连接 [#从控制台连接]
</div>

1. 前往设置中的 [Integrations](https://app.mintlify.com/settings/organization/integrations) 页面。
2. 找到集成并点击 **Connect**。
3. 完成授权流程。

配置自动化时，你也可以连接集成。在 **Advanced options** 下，在自动化的 **Integrations** 字段中选择尚未连接的应用，然后完成授权流程。

<div id="from-the-slack-agent">
  ### 从 Slack agent 连接 [#从-slack-agent-连接]
</div>

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

<div id="supported-integrations">
  ## 支持的集成 [#支持的集成]
</div>

控制台会显示当前可供你组织使用的集成。某些集成可能会逐步发布。

| 集成           | 范围 | 可用作自动化触发器 |
| ------------ | -- | --------- |
| Confluence   | 共享 | 是         |
| Contentful   | 共享 | 否         |
| Excel        | 个人 | 否         |
| Figma        | 共享 | 否         |
| Gmail        | 个人 | 否         |
| Google Drive | 个人 | 否         |
| HubSpot      | 共享 | 否         |
| Intercom     | 共享 | 否         |
| Jira         | 共享 | 是         |
| LaunchDarkly | 共享 | 否         |
| Linear       | 共享 | 是         |
| Notion       | 共享 | 是         |
| OneDrive     | 个人 | 否         |
| OneNote      | 个人 | 否         |
| Outlook      | 个人 | 否         |
| Plain        | 共享 | 否         |
| PostHog      | 共享 | 否         |
| Pylon        | 共享 | 否         |
| Salesforce   | 共享 | 否         |
| Stripe       | 共享 | 是         |
| Zendesk      | 共享 | 是         |

Pylon 是一个用于客户支持的共享只读集成。你可以使用它搜索支持工单，并检索工单消息、账户、联系人或用户信息。在 [Integrations](https://app.mintlify.com/settings/organization/integrations) 页面连接 Pylon。然后在 Slack agent 中使用它，或在自动化的 **Tools** 设置中选择它。

<div id="use-integrations-with-the-slack-agent">
  ## 在 Slack agent 中使用集成 [#在-slack-agent-中使用集成]
</div>

安装 [Mintlify Slack 应用](/zh/agent/slack)后，agent 可以在回答问题或更新文档时使用集成。你不需要为每次 Slack 对话选择集成。

Agent 可以使用：

* 已为组织连接的共享集成。
* 发送请求的团队成员所连接的个人集成。
* Mintlify 应用获准读取的 Slack 频道和线程。

Agent 仅在集成数据与请求相关时访问这些数据。

<div id="use-integrations-as-automation-tools">
  ## 将集成用作自动化工具 [#将集成用作自动化工具]
</div>

自动化工具会在自动化启动后为 agent 提供额外上下文。只能选择共享集成。

1. 打开自动化设置。
2. 展开 **Advanced options**。
3. 在 **Integrations** 中选择该自动化可以使用的集成。
4. 连接任何尚未连接的已选集成。
5. 保存自动化。

用作触发器的集成会自动添加为该自动化的工具，以便 agent 在收到事件后检索更多详细信息。

<div id="trigger-an-automation-from-an-integration">
  ## 通过集成触发自动化 [#通过集成触发自动化]
</div>

1. 创建或打开自定义自动化。
2. 在 **Trigger** 中选择 **Integration**。
3. 选择或连接一个共享集成，或选择 **Slack**。
4. 选择 **Trigger event**，并填写出现的其他事件字段。
5. 保存并启用自动化。

每个自动化只能有一个触发器。选择 **Integration** 会替代内容更新、代码变更或自定义计划触发器。

| 集成         | 事件                            |
| ---------- | ----------------------------- |
| Confluence | 页面创建；向空间添加内容                  |
| Jira       | Issue 创建；issue 更新；项目创建        |
| Linear     | Issue 创建；issue 更新；项目创建；项目更新发布 |
| Notion     | 页面创建；页面内容更新                   |
| Slack      | 所选频道中的新消息                     |
| Stripe     | 产品创建                          |
| Zendesk    | Ticket 创建                     |

事件发生时，Mintlify 会启动自动化，并将事件数据作为 agent 的上下文。

<div id="slack-channel-message-triggers">
  ### Slack 频道消息触发器 [#slack-频道消息触发器]
</div>

将 **Slack** 选为触发器集成，可在有人在你选择的频道中发布新消息时运行自定义自动化。需要安装 [Mintlify Slack 应用](/zh/agent/slack)，并已将其添加到你选择的每个频道。

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

<div id="permissions-and-access">
  ## 权限与访问 [#权限与访问]
</div>

Agent 可用的第三方集成工具均为只读。Agent 可以搜索和检索内容，但不能使用这些工具在已连接的应用中创建、编辑或删除数据。

Agent 会继承授权连接的账户所拥有的访问权限。若要缩小访问范围，请限制该账户的权限，或只向 Mintlify 应用开放特定资源。连接应用之前，请在授权页面查看具体权限。

<div id="disconnect-an-integration">
  ## 断开集成 [#断开集成]
</div>

1. 前往 [Integrations](https://app.mintlify.com/settings/organization/integrations) 页面。
2. 点击该集成的 **Configure**。
3. 点击 **Disable integration**。

断开共享集成会为整个组织移除该集成，并停止将其用作触发器的自动化接收新事件。断开个人集成只会移除你自己的连接。

<div id="troubleshoot-a-connection">
  ## 排查连接问题 [#排查连接问题]
</div>

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