你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 Bot Framework SDK 创建机器人

适用于:SDK v4

本文介绍如何使用 Bot Framework SDK for C#、Java、JavaScript 或 Python 生成第一个机器人,以及如何使用 Bot Framework Emulator 测试机器人。

创建第一个机器人不需要 Azure 订阅或 Azure AI 机器人服务资源。 本快速入门重点介绍如何在本地创建第一个机器人。 若要了解如何在 Azure 中创建机器人,请参阅创建 Azure 机器人资源

注意

Bot Framework JavaScript、C# 和 Python SDK 将继续受支持,但 Java SDK 即将停用,最终长期支持将于 2023 年 11 月结束。

使用 Java SDK 构建的现有机器人将继续正常运行。

对于新的机器人生成,请考虑使用 Microsoft Copilot Studio 并阅读选择 正确的 copilot 解决方案

有关详细信息,请参阅机器人构建的未来

先决条件

C# 模版

当前机器人示例使用 .NET Core 3.1 模板。

若要将机器人模板添加到 Visual Studio,请下载并安装 Bot Framework v4 SDK Templates for Visual Studio VSIX 文件。

注意

可以在 Visual Studio 中安装模板。

  1. 在菜单中,选择扩展,然后选择管理扩展
  2. 管理扩展对话框中,搜索并安装 Bot Framework v4 SDK templates for Visual Studio

有关将 .NET 机器人部署到 Azure 的信息,请参阅如何预配和发布机器人

创建机器人

在 Visual Studio 中,创建一个新的机器人项目并使用 Echo Bot (Bot Framework v4 - .NET Core 3.1) 模板。 要仅显示机器人模版,请选择“AI 机器人”项目类型

得益于该模板,项目包含在此快速入门中创建机器人所需的所有代码。 无需任何其他代码即可测试机器人。

启动机器人

在 Visual Studio 中:

  1. 打开您的机器人项目。
  2. 运行项目而不进行调试。
  3. Visual Studio 将生成应用程序,将其部署到 localhost,然后启动 Web 浏览器以显示应用程序的 default.htm 页。

此时,机器人正在本地端口 3978 上运行。

启动模拟器并连接机器人

  1. 启动 Bot Framework Emulator。

  2. 选择模拟器的“欢迎”选项卡中的“打开机器人”。

  3. 输入机器人的 URL,即本地主机和端口,并将 /api/messages 添加到路径。 地址通常为:http://localhost:3978/api/messages

    打开机器人

  4. 然后选择“连接” 。

    向机器人发送消息,机器人将会回复。

    回显消息

后续步骤

  • 有关如何使用 Visual Studio 或 Visual Studio Code 以及 Bot Framework Emulator 进行调试的信息,请参阅调试机器人
  • 有关 devtunnel 的信息,请参阅 Tunneling (devtunnel)