AI助理服务集成 Microsoft Teams

核心概念

步骤一：在 DataWorks 获取 Bot 的 Teams 回调 URL

Teams 回调 URL 是 DataWorks 为当前实例生成的入站地址：用户在 Teams 中向 Bot 发送消息时，Microsoft Bot Framework 将该消息转发到此 URL，由 AI 助理网关接收并处理。因此步骤二需将该 URL 填写为 Bot 的 Messaging Endpoint。

1. 登录DataWorks 控制台，进入AI 助理服务 > 目标实例 > 基本信息 > 通道配置，单击 Microsoft Teams 卡片的配置。

2. 在配置对话框中查看 Teams 回调 URL，单击复制。回调 URL 为完整的 HTTPS 地址，格式类似：

   https://<AI助理网关域名>/<实例路径>/api/messages?apikey=sk-ai-assistants-...

   请完整复制，保留路径和 apikey 查询参数，不要手动拼接。

3. 保持当前配置对话框打开，前往 Microsoft 创建 Bot。该回调 URL 此时仅为实例预留，需在保存 Teams 渠道且实例进入运行中状态后方可生效。

步骤二：在 Teams 创建应用和 Bot

1. 打开 Teams Developer Portal 并登录目标 Microsoft 365 租户。在 Apps 中新建 Teams 应用，填写应用名称和基本信息。

2. 在左侧导航栏，选择Tools > Bot management > New Bot，输入 Bot 名称并创建。返回刚才创建的应用，在Configure > App features > Bot关联该 Bot。根据使用需求（私聊或群/频道）选择相应的 Bot 使用范围。Developer Portal 创建的 Bot 默认为单租户。

3. 将步骤一复制的完整 Teams 回调 URL 设置为该 Bot 的 Messaging Endpoint。若通过 Azure Bot 管理注册，在 Azure Portal 的 Bot 资源中打开Settings > Configuration填写并保存，再在 Channels 开启 Microsoft Teams。

4. 获取本次 Bot 注册对应的 Client ID、Client Secret 和租户 ID。若使用 Microsoft Entra 应用注册，在 App registrations 中找到该应用，记录 Application (client) ID 和 Directory (tenant) ID，并在Certificates & secrets > New client secret创建密钥，复制 Value。

   说明

   不同租户的凭据和 Bot 注册可能由管理员统一管理。若页面无法查看这三项，请联系管理员提供同一注册的凭据，不要混用其他应用的凭据。

5. 在 Developer Portal 的 Preview in Teams 预览并安装应用，或请租户管理员发布到组织应用商店，再从 Teams 应用列表中添加。若需在群或频道中对话，还需将应用添加到目标群或频道。

可选：若具备开发权限，也可以使用 Teams Developer CLI 一次创建应用、Bot 和凭据。详情请参见官方 CLI 流程。

teams login --device-code
teams app create --name "DataWorks AI Assistant" \
  --endpoint "<步骤一复制的完整 Teams 回调 URL>"

命令完成后，保存输出的 Teams App ID/Bot ID、Client ID、Client Secret、租户 ID 。

步骤三：在 DataWorks 保存 Teams 渠道

1. 在步骤一保留的配置对话框中，填写以下参数。三项必须与同一个 Bot 注册对应。

   参数	说明
   Client ID	Bot 使用的 Microsoft 应用 ID。
   Client Secret	应用注册的密钥值。
   租户 ID	Microsoft Entra 租户 ID，而非 DataWorks 租户 ID。

2. 选择群聊范围：

   • 所有群成员可 @ 助理（默认）：机器人加入群/频道后，成员需 @ 它才触发回复。

   • 仅私聊：只开放私聊场景。

3. 单击保存。实例可能重启，请待其状态恢复为运行中。可在 Teams 卡片的 URL 回调中再次查看已保存的回调 URL。

   说明

   若页面提示“地址已预留但网关尚未就绪”，请稍后重试或单击重试配置，无需立即轮换 API Key。

步骤四：检查通道并发起私聊申请

1. 在实例详情的访问控制 IP 白名单中配置允许接入的回调来源 IP。由于 Microsoft 未提供 Bot Framework 回调的固定来源 IP 列表，为稳定接收 Teams 消息，通常需放行全部来源 IP（0.0.0.0/0）。更多信息，请参见微软官方说明。

   重要

   该 IP 白名单与企业微信 URL 回调共用；放行 0.0.0.0/0 后，企业微信 URL 回调的来源 IP 限制也会同步放开。

2. 在 Microsoft Teams 卡片中单击测试网络连通性。若出站未打通，单击开启通道网络并按页面指引完成。

3. 在 Teams 中打开已安装的应用，向 Bot 发送“你好”。首次私聊未获批准时，Bot 会提示联系实例管理员并显示配对码。该消息仅用于发起配对申请，不会执行实际提问。请记录配对码，步骤五中管理员批准私聊时需进行校验。

步骤五：管理员批准私聊，用户重新发送消息

1. 实例管理员进入AI 助理服务 > 目标实例 > 基本信息 > Microsoft Teams 卡片，将鼠标悬浮在 URL 回调上，在浮层中单击私聊配对。实例需处于运行中，否则入口不可用。

2. 单击刷新，在待批准申请中查看申请人名称、用户 ID、配对码和申请时间。与用户在 Teams 收到的配对码及身份核对后，单击对应申请的批准私聊，并在确认对话框中再次核对确认。

   说明

   申请有效期约 1 小时。申请过期时，请用户回到 Teams 重新发送消息以重新申请。

3. 页面提示批准成功后，确认申请人出现在已允许私聊列表。若出现“重试保存”或“批准结果尚未确认”，请按页面提示重试并确认已保存。

4. 用户回到 Teams，重新发送“你好”或实际问题，收到助理回复即表示私聊验收完成。批准仅开放该申请人的私聊，不会自动放开其他用户。如需撤销，管理员可在已允许私聊列表单击该用户的禁用并确认；被禁用的用户需重新发起配对。

步骤一：在 Teams 创建通知工作流并复制 Webhook URL

1. 确定通知的目标聊天或频道，请选择与实际接收位置一致的模板。

   • 频道场景：在 Teams 中找到目标团队和频道，单击频道旁的… > Workflows/工作流，选择 Send webhook alerts to a channel。

   • 聊天场景：从聊天的 Workflows 入口或 Teams 左侧的 Workflows 应用，搜索 Send webhook alerts to a chat。

2. 按模板选择目标聊天或团队/频道，检查工作流的发送身份及连接，单击保存。保存后进入工作流详情页，单击复制 Webhook URL。后续可在Workflows > Your workflows中找到该工作流，查看运行记录并管理 URL。详情请参见Microsoft 创建 Workflows Incoming Webhook 的步骤。

3. 当前，AI 助理服务通过 Workflows 推送时不会附加 Microsoft OAuth Bearer Token，即以匿名方式调用触发器。因此，在 Teams 工作流的触发器配置中，须将“谁可以调用触发器”设置为 Anyone/任何人；若设置为需鉴权的调用方，推送请求将因缺少 Token 被拒绝。

   重要

   若组织安全策略不允许将触发器调用方设置为 Anyone，当前版本的 AI 助理服务无法直接向该 Webhook URL 推送，须由管理员配置 OAuth 鉴权方案后方可使用。

4. 将复制的 URL 作为密钥保存。该 URL 仅用于此通知场景，不使用 Bot Client Secret。

步骤二：通过对话创建 Teams 定时任务

在AI 助理服务 > 目标实例 > 打开对话中与助理单独交互。不要在多人群聊中粘贴带签名的 Workflows URL。您可以复制以下示例，并将尖括号内容替换为实际值：

请创建定时任务“每日失败任务汇总”：每天北京时间 09:00，统计工作空间 <工作空间 ID> 昨日失败任务，按失败原因汇总并给出处理建议，只生成报告，不自动重跑。请把结果单向推送到这个 Teams Workflows Webhook URL：<步骤一复制的完整 URL>，使用 webhook 推送目标。创建前先告诉我任务名称、执行时间、巡检范围与目标聊天名称；创建后告诉我任务是否启用、如何查看和暂停，不要在回复里回显 URL 的签名参数。

按助理追问补齐工作空间等信息，核对后再创建。随后在对话中发送查看定时任务确认状态，或在指令后追加任务名称以查看单个任务；如需调整，可发送“暂停/恢复定时任务 <任务名称>”或“把该任务改为每天 10:00”。任务到达计划执行时间后，在 Teams 目标聊天/频道查看卡片，并前往 Workflows 运行记录核对是否收到触发。

步骤三：通过对话创建巡检

您可以复制以下示例，并将尖括号内容替换为实际值：

请为工作空间 <工作空间 ID> 创建“异常实例巡检”：每 5 分钟检查一次，报告每 30 分钟推送到这个 Teams Workflows Webhook URL：<步骤一复制的完整 URL>。单实例最多自动重跑 1 次。请先列出巡检范围、自动重跑条件、时间与推送目标供我确认，确认后再创建；不要在回复中回显 URL 的签名参数。

您确认巡检范围、自动重跑条件与推送目标后，助理创建任务并返回创建结果；随后在对话中发送“查看定时任务 异常实例巡检”确认任务状态。

场景一：聊天问题排查

场景二：主动推送问题排查