配置 Microsoft Teams 通知

重要

此功能目前以公共预览版提供。

AI/BI 仪表板支持将计划快照发送到 Microsoft Teams 频道。 这使团队可以直接在 Teams 工作区中接收仪表板更新。 本页介绍如何创建 Microsoft Teams 应用并将 Teams 频道配置为通知目标。 然后,仪表板编辑器可以将此通知目标作为订阅者添加到计划仪表板。 有关将 Teams 频道添加为订阅者的信息,请参阅 订阅 Slack 或 Microsoft Teams 频道

Teams 订阅提供仪表板快照,其中包括:

  • 通道中直接可见的仪表板的 PNG 图像快照
  • 在 Azure Databricks 中打开仪表板的直接链接
  • 消息线程中的 PDF 格式的快照附件

要求

必须具有以下权限:

  • 必须是 Azure Databricks 工作区管理员才能配置通知目标。

  • 必须在 Microsoft Copilot Studio 中创建和配置应用并Microsoft Entra ID 中具有相应的权限。

在安装过程中,从Microsoft收集身份验证凭据以配置 Azure Databricks 通知目标。

配置通知位置后,任何拥有仪表板编辑权限的用户都可以将 Teams 位置添加为他们管理的计划的订阅者。

步骤 1:创建和配置 Microsoft Teams 应用

为 Teams 工作区创建 Microsoft Copilot Studio 机器人并配置必要的权限。

创建 Microsoft Copilot Studio 机器人

从 Microsoft Copilot Studio 文档中完成以下步骤:

  1. 在 Microsoft Teams 中安装 Copilot Studio 应用

  2. 在团队中创建新的聊天机器人

在 Microsoft Entra ID 中配置应用权限

  1. 转到 Microsoft Entra 管理中心

  2. 单击 “应用程序 > 应用注册”。

  3. 使用上一步骤中的应用程序 ID 查找并选择与 Copilot Studio 机器人关联的应用注册。

  4. 在左侧栏中,单击 “API 权限”。

  5. 单击“添加权限”。

  6. Microsoft API 中,单击 Microsoft Graph > 应用程序权限

  7. 添加以下权限:

    • Files.Read.All
    • Sites.ReadWrite.All
  8. 单击“添加权限”。

  9. 单击“ 授予管理员同意 ”以授予组织的权限。

创建身份验证机密

  1. 在Microsoft Entra 管理中心,选择应用注册后,单击“ 证书和机密”。
  2. 单击 “客户端机密 > 新建客户端机密”。
  3. 输入说明并选择到期期限。
  4. 单击 添加
  5. 复制新创建机密的 。 此值仅显示一次,您需要用它来配置 Azure Databricks 通知目标。

获取租户 ID

  1. 在Microsoft Entra 管理中心,选择应用注册后,导航到 “概述”。
  2. 复制 目录(租户)ID。 需要此值才能配置 Azure Databricks 通知目标。

发布机器人并添加到 Teams 频道

完成 Azure Copilot Studio 文档中的以下步骤:

  1. 发布聊天机器人
  2. 使聊天机器人可供其他员工使用

为通道创建传入 Webhook

  1. 在 Microsoft Copilot Studio 文档中,按照以下步骤,创建传入的网络钩子

  2. 复制并保存生成的 Webhook URL。

  3. 单击“完成”。

复制生成的 Webhook URL。

获取 Microsoft Teams 频道的 URL 链接

  1. 在 Microsoft Teams 中,导航到目标通道。
  2. 单击频道名称旁边的汉堡菜单 ••••
  3. 单击 “复制”链接。 确保复制频道 URL 而不是 Teams URL。 需要此 URL 才能配置 Azure Databricks 通知目标。

步骤 2:在 Azure Databricks 中配置通知目标

在 Azure Databricks 工作区中创建指向 Microsoft Teams 通道的通知目标。

  1. 登录到 Azure Databricks 工作区。

  2. 单击工作区右上角的用户名。

  3. 从下拉列表中选择 “设置 ”。

  4. 在“工作区管理员”部分中,单击“通知”选项卡。

  5. “通知目标”部分中单击“管理”。

  6. 单击“ 添加目标”。

  7. 从目标类型下拉列表中选择 Microsoft Teams

  8. 输入以下信息:

    • 名称:此 Teams 频道目标的描述性名称
    • Microsoft teams Webhook URL:来自 Teams 传入 Webhook 的 Webhook URL
    • 应用 ID:来自 Microsoft Copilot Studio 机器人的应用 ID
    • 身份验证机密:来自 Microsoft Entra ID 的客户端机密值
    • 频道 URL:来自 Microsoft Teams 的频道 URL
    • 租户 ID:Microsoft Entra ID 中的租户目录 ID
  9. 单击 “创建”

    创建新的团队目标。

用户现在可以将此 Teams 通知目标作为订阅者添加到仪表板日程。

有关订阅 Teams 频道到仪表板计划的说明,请参阅 订阅 Slack 或 Microsoft Teams 频道

Troubleshooting

使用以下命令排查 Microsoft Teams 通知的常见错误。

缺少 PDF 附件

如果 Teams 通知未显示 PDF 附件,请验证:

  • 通知目标中已经正确配置了应用 ID。
  • 身份验证机密有效且未过期
  • 已向应用授予 Microsoft Entra ID 中的 Files.Read.AllSites.ReadWrite.All 必需权限
  • 已为 API 权限授予管理员同意

通知未显示

如果通知未显示在 Teams 频道中:

  • 验证 Webhook URL 是否正确,并匹配目标通道
  • 检查聊天机器人是否已发布并添加到目标频道
  • 确保通道 URL 正确
  • 验证租户 ID 是否与Microsoft组织匹配
  • 确认计划处于活动状态且未暂停

后续步骤