跳转到主要内容
如果你的 Slack 工作区所有者要求安装应用需先经管理员批准,请先请他们批准 Mintlify 应用,然后再进行连接。

连接你的 Slack 工作区

  1. 在控制台中进入 Agent 页面。
  2. 在 “Agent settings” 部分,点击 Install Slack app
应用设置区域,包含 Slack 和 Linear 安装按钮。
  1. 按照 Slack 的提示将 mintlify 应用安装到你的工作区。
  2. 按照 Slack 的提示将你的 Mintlify 账户关联到你的 Slack 工作区。
  3. 测试 agent 是否正常工作,并在你执行以下操作时是否会响应:
    • 向 agent 发送一条私信。
    • 在频道中使用 @mintlify 提及 agent。

在 Slack 中使用智能体

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

更新文档

使用智能体在新请求或现有线程中更新你的文档。
  • 新请求:向智能体发送直接消息,或在频道中提及 @mintlify,并说明需要更新的内容。
  • 现有线程:在该线程中回复并提及 @mintlify,并说明需要更新的内容。
  • 包含附件:在消息中上传图片、图表、代码文件或其他文档。智能体会自动处理这些附件,并将其内容纳入你的文档中。
智能体会读取请求或线程的上下文,并在你已连接的存储库中创建一个包含这些更新的拉取请求(PR;亦称“合并请求”/Merge Request)。

最佳实践

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