在 Teams 桌面客户端中调试

Microsoft 365 代理工具包 (以前称为 Teams 工具包) 可帮助你在桌面客户端中调试和预览 Microsoft Teams 应用。 在调试过程中,Agents Toolkit 会自动启动应用服务、打开调试器并上传 Teams 应用。 调试后,可以在 Teams 桌面客户端中预览 Teams 应用。

以下是 Teams 桌面客户端的优点:

  • 提高性能。
  • 缩短到 F5 的时间。
  • 改进调试目标的覆盖范围。

Teams 桌面客户端的功能

Teams 桌面客户端将调试功能合并到代理工具包基架的以下应用模板中:

  • 机器人。
  • 代理。
  • 自定义引擎代理。
  • 消息扩展。

先决条件

请确保安装以下工具,用于在 Teams 桌面客户端中生成和部署应用:

  安装 用于使用...
  Microsoft 365 代理工具包 一个Microsoft Visual Studio Code扩展,用于为应用创建项目基架。 使用最新的预发行版。
  Node.js 后端 JavaScript 运行时环境。 有关详细信息,请参阅 项目类型的node.js 版本兼容性表
  Visual Studio Code JavaScript、TypeScript 或 SharePoint 框架 (SPFx) 生成环境。 使用最新版本。
  Microsoft 365 开发人员帐户 具有安装应用的相应权限的 Teams 帐户的访问权限。

在 Teams 桌面客户端中调试

在 Teams 桌面客户端中调试自定义引擎代理应用

  1. 打开 Visual Studio Code (VS Code) ,并通过代理工具包登录到 Microsoft 365 帐户。

  2. 打开 Teams 代理或应用项目。

    若要详细了解如何创建新代理或应用,请参阅在 Teams 中生成第一个代理或应用。

  3. 在左窗格中,选择 “运行”和“调试 (Ctrl+Shift+D) 并从下拉列表中选择” 在 Teams (桌面) 调试”。

    屏幕截图显示用于在 Teams (桌面) 中选择调试的选项。

  4. 确保 Teams 桌面登录名与代理工具包中使用的 Microsoft 365 帐户匹配,然后选择“ 继续”。

    显示桌面登录名的屏幕截图。

    Teams 桌面客户端请求添加应用。

  5. 选择“添加”。

    屏幕截图显示了用于将应用添加到 Teams 桌面客户端的“添加”按钮。

    此时会打开聊天窗口。

  6. 在消息撰写区域中,发送消息以调用机器人。

    屏幕截图显示添加到 Teams 桌面客户端的应用。

    注意

    每个项目仅显示一次帐户匹配的系统级通知。 在后续的调试会话中,代理工具包通过 VS Code 通知发送有关帐户的提醒。

    屏幕截图显示与代码中的后续桌面登录通知。

  7. 可以添加断点和 热重载 更改。 在以下示例中,断点突出显示了行号旁边的红点。

    屏幕截图显示了应用中的断点示例。

    屏幕截图显示了应用热重载后的示例。

可以继续在 Teams 桌面客户端中调试自定义引擎代理应用。

另请参阅