用于 agent 和自动化的集成

集成将 Mintlify agent 与团队已在使用的工具连接起来。Agent 可以在 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 确认并使用该连接。

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

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

Agent 可以使用：

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

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

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

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

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

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

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

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

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

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

1. 前往 Integrations 页面。
2. 点击该集成的 Configure。
3. 点击 Disable integration。

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

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