使用 JavaScript 生成命令机器人

生成命令机器人

使用 Visual Studio Code 生成命令机器人

  1. 打开 Visual Studio Code。

  2. 选择“Visual Studio Code活动栏中的 Teams 工具包”图标。

  3. 选择“ 创建新应用”。

    Teams 工具包边栏中

  4. 选择“ 机器人 ”以创建新的机器人项目。

    屏幕截图显示用于创建新项目的向导。

  5. 确保已选择 “聊天命令 ”作为要在应用中生成的应用功能。

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

  6. 选择 JavaScript 作为编程语言。

    显示如何选择编程语言的屏幕截图。

  7. 选择“ 默认文件夹 ”,将项目根文件夹存储在默认位置。

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

    还可以通过以下步骤更改默认位置:

    1. 选择“ 浏览”。

      屏幕截图显示了选择的存储浏览位置。

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

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

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

  8. 为应用输入合适的名称。

  9. 选择“Enter”。

    显示输入应用程序名称的屏幕截图。

  10. 创建应用后,Teams 工具包会显示以下消息:

    屏幕截图显示了用于搭建基架的新窗口“通知”。

    命令机器人应用在几秒钟内创建。

    显示已创建的应用的屏幕截图。

  11. 从Visual Studio Code活动栏中选择“运行和调试”图标。

  12. 从下拉列表中选择“ 在 Teams (Edge) 中调试”或“在 Teams (Chrome) 中调试 ”。

  13. 选择“ 开始调试 ”按钮。 系统会提示将命令机器人应用上传到本地计算机上的 Teams。

    屏幕截图显示了调试应用程序。

  14. 选择“添加”。

    用于添加命令机器人应用的应用详细信息对话框的屏幕截图。

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

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

    “范围选择”对话框的屏幕截图,其中包含共享范围的列表。

  16. 选择 命令机器人

  17. 选择“Enter”。

    显示添加应用下拉列表的屏幕截图

    在自适应卡中收到以下命令响应:

    屏幕截图显示了最终输出。

了解源代码

Teams 工具包提供用于生成应用的组件。 创建项目后,可以在 Visual Studio Code 的“资源管理器”区域中查看项目文件夹和文件。

显示“结构”选项卡的屏幕截图

如果选择使用 UI 框架,则以下示例模板代码提供了一个基架,其中包含React组件。 它包含以下内容:

文件夹/文件 目录
teamsapp.yml 主项目文件描述应用程序配置,并定义要在每个生命周期阶段运行的作集。
teamsapp.local.yml 这将替代 teamsapp.yml 启用本地执行和调试的作。
env/ 名称/值对存储在环境文件中,由 teamsapp.yml 用于自定义预配和部署规则。
.vscode/ 用于调试的 VSCode 文件。
appPackage/ Teams 应用程序清单的模板。
infra/ 用于预配 Azure 资源的模板。
src/ 应用程序的源代码。
src/index.js 命令和 express 响应的应用程序入口点和处理程序。
src/teamsBot.js 用于机器人自定义的空团队活动处理程序。
src/adaptiveCards/helloworldCommand.json 发送到 Teams 的生成的自适应卡片。
src/helloworldCommandHandler.js 用于处理命令的业务逻辑。