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 桌面客户端中调试自定义引擎代理应用
打开 Visual Studio Code (VS Code) ,并通过代理工具包登录到 Microsoft 365 帐户。
选择 VS Code 活动栏中的“代理工具包”
图标,然后选择“创建新代理/应用”。
选择“ 自定义引擎代理”。
选择“ 基本自定义引擎代理”。
选择 “JavaScript”。
选择“ OpenAI”。
输入 OpenAI 服务密钥。
选择 “JavaScript”。
选择“ 默认文件夹”。
若要更改默认位置,请执行以下步骤:
选择“ 浏览”。
选择项目工作区的位置。
选择 “选择文件夹”。
为应用输入合适的 名称,然后选择 Enter 键。
在左窗格中,选择 “运行”和“调试 (
Ctrl+Shift+D
) 并从下拉列表中选择” 在 Teams (桌面) 调试”。确保 Teams 桌面登录名与代理工具包中使用的 Microsoft 365 帐户匹配,然后选择“ 继续”。
Teams 桌面客户端请求添加应用。
选择“添加”。
此时会打开聊天窗口。
在消息撰写区域中,发送消息以调用机器人。
注意
每个项目仅显示一次帐户匹配的系统级通知。 在后续的调试会话中,代理工具包通过 VS Code 通知发送有关帐户的提醒。
可以添加断点和 热重载 更改。 在以下示例中,断点突出显示了行号旁边的红点。
可以继续在 Teams 桌面客户端中调试自定义引擎代理应用。