构建交互式通知机器人应用

对于交互式通知,机器人在 Teams 频道、群组聊天或个人聊天中发送消息。 可以使用 HTTP 请求(例如卡片或文本)触发交互式通知机器人。 如需来自选项卡应用的主动通知,请使用 活动源通知。

屏幕截图显示了 Teams 客户端中的通知机器人概念

在本教程中,通过以下方式之一了解交互式通知机器人应用。

  • GitHub Codespaces:codespace 实例允许你即时体验 Teams 应用。 它将打开Visual Studio Code (VS Code) ,其中 Microsoft 365 Agents Toolkit (以前称为 Teams Toolkit) 扩展、应用源代码和所有依赖项都为你预先打包。
  • 分步指南:允许你从头开始设置开发环境并生成 Teams 应用。

创建 codespace 之前,请确保满足以下先决条件:

提示

GitHub Codespaces 提供每月固定使用量的免费计划。 如果需要释放更多空间,请转到 github.com/codespaces 并删除不再需要的 codespace。

若要使用 GitHub Codespaces 创建交互式 Teams 通知机器人,请执行以下步骤:

  1. 选择以下按钮打开 GitHub Codespaces。

    在 GitHub Codespaces 中打开 hello-world 选项卡

    如果尚未登录到 GitHub 帐户,系统可能会要求你登录。

  2. 选择“ 创建新的 codespace”。

    屏幕截图显示了用于为机器人创建 codespace 的 GitHub 页面。

    此时将显示“ 设置 codespace” 页。

    屏幕截图显示了生成通知机器人的 codespace。

    Agents Toolkit 将为您准备一个交互式通知机器人项目,并在浏览器的 VS Code 中打开它。 Microsoft 365 Agents Toolkit 图标显示在 VS Code 的活动栏中。

  3. 选择“登录到 Microsoft 365”和“登录到 Azure”以使用 Microsoft 365 帐户登录。

    屏幕截图显示浏览器中的 Agents Toolkit 窗口以登录。

    注意

    生成应用时,GitHub Codespaces 会将其加载到 Teams 客户端的新选项卡中。如果浏览器阻止弹出选项卡或窗口,则需要允许弹出窗口打开应用。

  4. 选择 “预览 Teams 应用” (F5) 。

    屏幕截图显示了浏览器中的 Agents Toolkit 窗口以及通知机器人。

    GitHub Codespaces 生成交互式通知机器人应用,将其加载到 Teams 客户端,并在单独的浏览器选项卡中打开它。

  5. 选择“ 添加 ”以在 Teams 中安装交互式通知机器人。

    用于在 Teams 中安装通知机器人应用的应用详细信息对话框的屏幕截图。

    添加应用后,将显示一个对话框,可在其中选择使用应用的范围。

  6. 选择 “打开 ”以在个人范围内打开应用。

    或者,可以搜索并选择所需的范围,或从列表中选择频道、聊天或会议,然后在对话框中移动以选择“ 转到”。

    范围选择对话框的屏幕截图,其中包含从共享范围内选择的选项。

  7. 在 codespace 中打开新终端,并运行以下命令来触发向机器人发送交互式通知的事件:

    curl -X POST http://localhost:3978/api/notification
    

    提示

    实时地,事件由外部源(如第三方 API)触发,从而导致通知机器人向用户发送交互式通知。 要模拟事件触发器,您可以通过终端上的 curl 命令手动发送事件。

    通知机器人应用会将交互式通知作为自适应卡片发送到 Teams 客户端:

    屏幕截图显示在 Teams 客户端中加载的通知机器人。

    现在,你已成功创建一个交互式通知机器人并将其加载到 Teams 客户端中。

如果想要构建邮件扩展,请转到:

如果您想构建基本的选项卡应用,请转到: