在 Teams 桌面客户端中调试

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

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

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

Teams 桌面客户端的功能

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

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

先决条件

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

  安装 用于使用...
  Teams 工具包 一个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) ,并通过 Teams 工具包登录到 Microsoft 365 帐户。

  2. 选择 VS Code 活动栏中的 Teams 工具包图标,然后选择“创建新应用”。

    屏幕截图显示了 Teams 工具包边栏中“创建新项目”链接的位置。

  3. 选择“ 自定义引擎代理”。

    屏幕截图显示了 Teams 工具包应用模板。

  4. 选择“ 基本 AI 聊天机器人”。

    屏幕截图显示要添加到新应用的应用功能。

  5. 选择 “JavaScript”。

    屏幕截图显示了用于选择编程语言的选项。

  6. 选择“ OpenAI”。

    屏幕截图显示了 Visual Studio Code 中的 LLM。

  7. 输入 OpenAI 服务密钥。

    显示如何在 Visual Studio Code 中输入 openai 服务密钥的屏幕截图。

  8. 选择“ 默认文件夹”。

    屏幕截图显示了默认位置的选择。

    若要更改默认位置,请执行以下步骤:

    1. 选择“ 浏览”。

      屏幕截图显示了用于浏览和选择位置的选项。

    2. 选择项目工作区的位置。

    3. 选择 “选择文件夹”。

      屏幕截图显示要选择的文件夹。

  9. 为应用输入合适的 名称,然后选择 Enter 键。

    屏幕截图显示输入应用名称的位置。

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

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

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

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

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

  12. 选择“添加”。

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

    此时会打开聊天窗口。

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

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

    注意

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

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

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

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

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

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

另请参阅