进阶 docs.budibase.com 2026-11-12 08:33:37 · 19 阅读
第13章 将智能体部署到 Microsoft Teams 消息通道
Microsoft Teams 消息通道
本指南介绍如何将智能体部署到 Microsoft Teams。
开始前准备
请确认您已具备以下条件:
- 拥有 Teams 访问权限的 Microsoft 365 租户
- 为机器人创建的 Azure 应用注册
- 已连接 AI 模型且正在运行的智能体
- 对 智能体 -> 目标智能体 -> 部署 的访问权限
在 Budibase 中配置 Microsoft Teams
- 在 智能体 中打开目标智能体
- 前往 部署 页面
- 在 消息通道 中,点击 Microsoft Teams 旁的 管理
- 填写以下信息:
- App ID(客户端 ID):必须是 Azure 提供的有效 UUID。
- Client secret(值)
- Directory(租户)ID(Azure AD 租户 ID)
- 空闲超时时间(分钟)(可选)
- 点击 保存通道
- 复制生成的 消息端点 URL
- 点击 下载应用包,获取包含 Teams 机器人 manifest 和图标的 zip 文件。该包可直接侧载到 Microsoft Teams。
配置 Teams 机器人端点
- 在 Azure 机器人配置中,将机器人消息端点设为 Budibase 消息端点 URL。
- 使用与租户 ID 匹配的单租户设置。
启用并验证
- 在 Budibase 的 部署 页面,将 Microsoft Teams 开关切换为 已启用
- 打开 Teams 并向机器人发送消息
- 运行 link 或 /link,完成 Budibase 账户链接流程
- 测试指令:
- ask <消息>:继续当前对话
- new <消息>:开启新对话
- unlink 或 /unlink:断开 Budibase 账户关联
纯文本消息将被视为 ask 指令。
如果你在完成绑定之前发送普通消息,Budibase 会发送一条私信提示你先绑定账号。同样,如果在绑定前对审批请求(escalation)作出回复,你的回复在你完成绑定流程之前不会被计入。 处理文档(RAG) 当你的 Agent 基于文档回答问题(检索增强生成)时,Budibase 会在 Teams 中提供具体的来源引用。 来源引用 在个人对话中,Agent 会在回复下方自动列出它生成答案时所引用的具体文档来源。 开启下载功能时:来源以可交互按钮的形式展示,每个按钮都带有经过身份验证的文件下载直链。 关闭下载功能时:来源仅以纯文本标签显示文件名,不提供下载链接。 出于隐私和安全考虑,Agent 在频道或群组对话中聊天时不会提供来源引用。 关闭来源下载 你可以通过 Agent 的运营设置来控制是否允许用户下载知识来源: 在 Agents 中打开你的 Agent 选择 Operations 标签页 找到你的 live operation,点击设置图标 如果你想禁止生成下载链接,关闭 Allow knowledge source download 开关。个人聊天中仍会显示来源名称,但可交互的下载按钮会被替换为纯文本。 故障排查 未在 Budibase 中完成配置:确认 App ID、Client secret 和 Tenant ID 已保存。 Teams 无法投递消息:检查 bot 消息端点是否与 Budibase URL 完全一致。 Teams 返回认证失败:检查 bot 凭据及租户配置是否正确。 Teams 在回答前提示绑定:运行 link 或 /link 命令,完成账号绑定流程。 Webhook 路由错误:使用 Deployment 中 Budibase 生成的端点 URL。 Microsoft Teams service URL 无效:Budibase 会验证所有 Teams House 交互是否来自可信的 Microsoft 服务来源。如果你使用的是特定区域或自定义的 Microsoft Teams 环境,可能需要在 Budibase 服务器上配置 TEAMS_API_URL 环境变量(例如 TEAMS_API_URL=https://smba.trafficmanager.net/apis/)以匹配你的环境。 相关指南 Messaging channels Slack messaging channel Discord messaging channel 更新于约 1 个月前 此页面对你有帮助吗?
如果你在完成绑定之前发送普通消息,Budibase 会发送一条私信提示你先绑定账号。同样,如果在绑定前对审批请求(escalation)作出回复,你的回复在你完成绑定流程之前不会被计入。 处理文档(RAG) 当你的 Agent 基于文档回答问题(检索增强生成)时,Budibase 会在 Teams 中提供具体的来源引用。 来源引用 在个人对话中,Agent 会在回复下方自动列出它生成答案时所引用的具体文档来源。 开启下载功能时:来源以可交互按钮的形式展示,每个按钮都带有经过身份验证的文件下载直链。 关闭下载功能时:来源仅以纯文本标签显示文件名,不提供下载链接。 出于隐私和安全考虑,Agent 在频道或群组对话中聊天时不会提供来源引用。 关闭来源下载 你可以通过 Agent 的运营设置来控制是否允许用户下载知识来源: 在 Agents 中打开你的 Agent 选择 Operations 标签页 找到你的 live operation,点击设置图标 如果你想禁止生成下载链接,关闭 Allow knowledge source download 开关。个人聊天中仍会显示来源名称,但可交互的下载按钮会被替换为纯文本。 故障排查 未在 Budibase 中完成配置:确认 App ID、Client secret 和 Tenant ID 已保存。 Teams 无法投递消息:检查 bot 消息端点是否与 Budibase URL 完全一致。 Teams 返回认证失败:检查 bot 凭据及租户配置是否正确。 Teams 在回答前提示绑定:运行 link 或 /link 命令,完成账号绑定流程。 Webhook 路由错误:使用 Deployment 中 Budibase 生成的端点 URL。 Microsoft Teams service URL 无效:Budibase 会验证所有 Teams House 交互是否来自可信的 Microsoft 服务来源。如果你使用的是特定区域或自定义的 Microsoft Teams 环境,可能需要在 Budibase 服务器上配置 TEAMS_API_URL 环境变量(例如 TEAMS_API_URL=https://smba.trafficmanager.net/apis/)以匹配你的环境。 相关指南 Messaging channels Slack messaging channel Discord messaging channel 更新于约 1 个月前 此页面对你有帮助吗?