进阶 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 个月前 此页面对你有帮助吗?

评论 (0)