第14章 通过Slack消息通道部署Agent
第14章 Slack 消息通道
使用本指南将 Agent 部署到 Slack。
开始之前
请确认你已具备:
- 一个可以创建应用的 Slack 工作区 - 一个已连接 AI 模型、可正常运行的 Agent - Agents -> 你的 Agent -> Deployment 的访问权限
在 Budibase 中配置 Slack
1. 在 Agents 中打开你的 Agent 2. 进入 Deployment 3. 在 Messaging channels 中,点击 Slack 旁边的 Manage 4. 填写: - Bot token - Signing secret - Idle timeout (minutes)(可选) 5. 点击 Save channel 6. 复制生成的 Messaging endpoint URL 7. (可选)将 File attachments 开关设为 Enabled。这需要在 Budibase 服务器环境中设置 GEMINI_API_KEY。
配置 Slack 应用
1. 创建或更新应用
为你的工作区创建一个 Slack 应用,或使用现有应用。
2. 添加 bot 权限范围
在 OAuth & Permissions 中添加:
- chat:write - app_mentions:read - im:history - channels:history - groups:history - mpim:history - users:read - files:read
3. 配置事件订阅
1. 打开 Event Subscriptions 2. 启用事件 3. 将 Request URL 设置为 Budibase 的 Messaging endpoint URL 4. 订阅以下 bot 事件: - app_mention - message.im - message.channels - message.groups - message.mpim
4. 重新安装应用
修改权限范围或事件后,需将应用重新安装到工作区。
5. 邀请 bot
将 bot 邀请到需要它服务的频道,例如:
/invite @your-bot
启用并验证
1. 在 Budibase 的 Deployment 中,将 Slack 开关设为 Enabled 2. 在 Slack 中,在某个频道提及 bot 或发送私信 3. 运行 /link 并完成 Budibase 账号绑定流程 4. 运行 /unlink 可解绑账号 5. 发送一条消息,确认 Agent 有响应
Slack 的线程(thread)用作会话边界。在频道线程中,想让 Agent 处理的每条消息都必须提及它。在私信(DM)中,Agent 会自动回复每条消息。
如果绑定前发送消息,Budibase 会私信提示你先完成账号绑定。同样,如果绑定前就回复了审批请求(升级),该回复在完成绑定流程前不会被计入。
斜杠命令
- /ask
处理文档(RAG)
当 Agent 使用文档回答问题(检索增强生成)时,Budibase 可以在 Slack 中提供这些来源的直接下载链接。
来源引用
在私聊(DM)中,Agent 会自动在回复末尾附上生成答案所用文档来源的列表,每个来源都包含带鉴权的文件直接下载链接。
为保障隐私和安全,Agent 在频道或群组会话中聊天时不提供来源下载链接。
会话附件
如果在 Agent 部署设置中启用了 File attachments,用户可以直接在 Slack 会话中上传文件。Agent 会处理这些文件,并利用其内容回答该线程中后续的问题。
- 支持格式:PDF、CSV、TXT、Markdown、JSON、YAML、XML。 - 限制:每个会话最多 3 个文件,单个文件最大 20MB。 - 清理文件:使用 /new 命令清除已附加的文件并开启新会话。
故障排查
- 未在 Budibase 中配置:确认 Bot token 和 Signing secret 均已保存。 - Slack 事件未到达 Budibase:重新检查 Request URL,并在修改权限/事件后重新安装应用。 - Bot 在频道中无响应:确认已将该 bot 邀请到对应频道。 - Bot 在回答前提示绑定:在 Slack 中运行 /link 并完成绑定跳转。 - Webhook 路由错误:使用 Deployment 中 Budibase 生成的准确 endpoint URL。 - 文件处理失败:确认 GEMINI_API_KEY 配置正确,且 Slack 应用具有 files:read 权限。
相关指南
- Messaging channels - Microsoft Teams messaging channel - Discord messaging channel
更新于约 2 个月前 这个页面对你有帮助吗?