mintlify__docs/zh/agent/slack.mdx

---
title: "将 agent 添加到 Slack"
description: "在 Slack 中使用 agent，从会话中更新文档并沉淀团队知识。"
keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", "知识沉淀"]
---

<Note>
  如果你的 Slack 工作区所有者要求安装应用需先经管理员批准，请先请他们批准 Mintlify 应用，然后再进行连接。
</Note>

<div id="connect-your-slack-workspace">
  ## 连接你的 Slack 工作区
</div>

1. 在控制台中进入 [Agent](https://dashboard.mintlify.com/products/agent) 页面。
2. 在 "Agent settings" 部分，点击 **Install Slack app**。
  <Frame>
    <img src="/images/agent/install-apps-light.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="block dark:hidden" />
    <img src="/images/agent/install-apps-dark.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="hidden dark:block" />
  </Frame>
3. 按照 Slack 的提示将 `mintlify` 应用安装到你的工作区。
4. 按照 Slack 的提示将你的 Mintlify 账户关联到你的 Slack 工作区。
5. 测试 agent 是否正常工作，并在你执行以下操作时是否会响应：
   - 向 agent 发送一条私信。
   - 在频道中使用 `@mintlify` 提及 agent。

<div id="use-the-agent-in-slack">
  ## 在 Slack 中使用智能体
</div>

连接完成后，你可以：

- 向智能体发送私信，在私密环境中使用它来更新文档。
- 在频道中提及 `@mintlify`，在公开场景中与团队协作使用它。
- 在消息中直接附加文件和图片，让智能体处理并将其纳入文档。
- 在线程中继续对话，对修改内容持续迭代。
- 将拉取请求（PR；亦称“合并请求”/Merge Request）链接分享给智能体，以更新相关文档。

<div id="update-documentation">
  ## 更新文档
</div>

使用智能体在新请求或现有线程中更新你的文档。

- **新请求**：向智能体发送直接消息，或在频道中提及 `@mintlify`，并说明需要更新的内容。
- **现有线程**：在该线程中回复并提及 `@mintlify`，并说明需要更新的内容。
- **包含附件**：在消息中上传图片、图表、代码文件或其他文档。智能体会自动处理这些附件，并将其内容纳入你的文档中。

智能体会读取请求或线程的上下文，并在你已连接的存储库中创建一个包含这些更新的拉取请求（PR；亦称“合并请求”/Merge Request）。

<div id="best-practices">
  ## 最佳实践
</div>

- **具体说明**：清楚地告诉 agent 你希望文档记录哪些内容，以及它应该放在哪里。
- **添加上下文信息**：如果一个对话中不包含所有必要信息，请在发给 agent 的消息中补充更多细节。
- **仔细审查**：在合并之前，你应始终审查 agent 创建的拉取请求（PR；亦称“合并请求”/Merge Request）。