Создание бота с помощью службы Azure BotCreate a bot with Azure Bot Service

применимо к: Пакет SDK v4APPLIES TO: SDK v4

Служба Azure Bot предоставляет основные компоненты для создания ботов, включая пакет SDK Bot Framework для разработки ботов и службу ботов для подключения ботов к каналам.Azure Bot Service provides the core components for creating bots, including the Bot Framework SDK for developing bots and the bot service for connecting bots to channels. В этой статье показано, как создать робот с помощью пакета SDK для Bot Framework v4 и выбрать шаблон .NET или Node.js.This article shows how to create a bot using the Bot Framework SDK v4 and choosing either .NET or Node.js template.

Существует два подхода к созданию программы-робота с помощью Azure.You have two approaches to create a bot with Azure:

  1. Веб-приложение.Web App. Создайте робот и зарегистрируйте его в Azure с помощью веб-приложения, как показано в этой статье.Create a bot and register it with Azure using a Web application as shown in this article. Этот подход используется при разработке и размещении программы-робота в Azure.You use this approach if you develop and host a bot in Azure.
  2. Регистрация каналов Bot.Bot channels registration. Создавайте и разрабатывайте программу Bot локально и размещайте ее на платформе, отличной от Azure.Create and develop your bot locally and host it on a platform different from Azure. При регистрации робота вы предоставляете веб-адрес, на котором размещена программа Bot.When you register your bot, you provide the web address where your bot is hosted. Вы по-прежнему можете разместить его в Azure.You can still host it in Azure. Выполните действия, описанные в статье о регистрации каналов Bot .Follow the steps described in the Bot channels registration article.

Создание бота с помощью службы Azure Bot и локальных средств — это независимые друг от друга параллельные процессы.Creating a bot with Azure Bot Service and creating a bot locally are independent, parallel ways to create a bot.

Предварительные требованияPrerequisites

Создание службы ботовCreate a new bot service

  1. Войдите на портал Azure.Log in to the Azure portal.

  2. Щелкните ссылку создать ресурс в верхнем левом углу портал Azure.Click Create a resource link found in the upper left-hand corner of the Azure portal.

  3. В поле поиска введите Bot и в раскрывающемся списке выберите веб-приложение Bot.In the search box enter bot and in the drop-down list select Web App Bot.

    Bot веб-приложения

  4. На странице программы веб-приложения "робот " нажмите кнопку создать .In the Web App Bot page, click the Create button.

    Создание веб-приложения Bot

  5. В форме Bot веб-приложения Укажите запрашиваемые сведения о программе Bot, как указано в таблице под изображением.In the Web App Bot form, provide the requested information about your bot as specified in the table below the image.

    Колонка создания бота веб-приложения

    ПараметрSetting Рекомендуемое значениеSuggested value ОписаниеDescription
    Имя ботаBot name Отображаемое имя вашего ботаYour bot's display name Отображаемое имя бота, которое показывается на каналах и в каталогах.The display name for the bot that appears in channels and directories. Это имя можно изменить в любое время.This name can be changed at anytime.
    ПодпискаSubscription Ваша подпискаYour subscription Выберите подписку Azure, которую нужно использовать.Select the Azure subscription you want to use.
    Группа ресурсовResource Group myResourceGroupmyResourceGroup Вы можете создать группу ресурсов или выбрать имеющуюся.You can create a new resource group or choose from an existing one.
    РасположениеLocation Расположение по умолчаниюThe default location Выберите географическое расположение для группы ресурсов.Select the geographic location for your resource group. Вы можете выбрать любое расположение в списке, но лучше всего выбрать расположение, ближайшее к вашему клиенту.Your location choice can be any location listed, though it's often best to choose a location closest to your customer. Расположение нельзя изменить после создания бота.The location cannot be changed once the bot is created.
    Ценовая категорияPricing tier F0F0 Выберите ценовую категорию.Select a pricing tier. Вы можете обновить ценовую категорию в любое время.You may update the pricing tier at any time. Дополнительные сведения см. на странице цен на службу Bot.For more information, see Bot Service pricing.
    Имя приложенияApp name Уникальное имяA unique name Уникальный URL-адрес бота.The unique URL name of the bot. Например, если вы используете для бота имя myawesomebot, его URL-адресом будет http://myawesomebot.azurewebsites.net.For example, if you name your bot myawesomebot, then your bot's URL will be http://myawesomebot.azurewebsites.net. В имени нужно использовать только буквы, цифры и символ подчеркивания.The name must use alphanumeric and underscore characters only. Допустимое число символов для этого поля: 35.There is a 35 character limit to this field. Имя приложения нельзя изменить после создания бота.The App name cannot be changed once the bot is created.
    Bot template (Шаблон бота)Bot template Бот EchoEcho bot Выберите SDK v4 (Пакет SDK версии 4).Choose SDK v4. Выберите C# или Node.js для работы с этим кратким руководством, затем нажмите кнопку Выбрать.Select either C# or Node.js for this quickstart, then click Select.
    Расположение или план службы приложенийApp service plan/Location План службы приложенийYour app service plan Выберите расположение плана службы приложений.Select an app service plan location. Вы можете выбрать любое расположение в списке, но обычно рекомендуется выбирать расположение, в котором находится служба бота.Your location choice can be any location listed, though it's often best to choose the same location as the bot service.
    Учетные записи LUIS доступны только для шаблона Базового ботаLUIS Accounts Only available for Basic Bot template Имя ресурса LUIS в AzureLUIS Azure Resource Name После переноса ресурсов LUIS в ресурс Azure введите имя ресурса Azure, чтобы связать приложение LUIS с этим ресурсом Azure.After migrating LUIS Resources over to an Azure Resource, input the Azure Resource name to associate this LUIS Application with that Azure Resource.
    Application InsightsApplication Insights СOn Решите, хотите ли вы включить или выключить Application Insights.Decide if you want to turn Application Insights On or Off. Если вы выберете параметр Вкл. , необходимо также указать региональное расположение.If you select On, you must also specify a regional location. Вы можете выбрать любое расположение в списке, но обычно рекомендуется выбирать расположение, в котором находится служба бота.Your location choice can be any location listed, though it's often best to choose the same location as the bot service.
    Microsoft App ID and password (Идентификатор и пароль приложения Майкрософт)Microsoft App ID and password Auto create App ID and password (Автоматическое создание идентификатора и пароля приложения)Auto create App ID and password Используйте этот параметр, если вам нужно вручную ввести идентификатор и пароль приложения Майкрософт.Use this option if you need to manually enter a Microsoft App ID and password. В противном случае они будут созданы при создании бота.Otherwise, a new Microsoft App ID and password will be created for you in the bot creation process. При создании регистрации приложения вручную для службы Bot убедитесь, что для поддерживаемых типов учетных записей заданы учетные записи в любом каталоге Организации или учетных записях в любом каталоге Организации и личных учетных записях Майкрософт (например, Outlook.com, Xbox и т. д.).When creating an app registration manually for the Bot Service, please ensure that the supported account types is set to Accounts in any organizational directory or Accounts in any organizational directory and personal Microsoft accounts (e.g. Outlook.com, Xbox, etc.)
  6. Нажмите кнопку Создать для создания службы и развертывания бота в облаке.Click Create to create the service and deploy the bot to the cloud. Это может занять несколько минут.This process may take several minutes.

    Убедитесь, что бот был развернут, проверив раздел Уведомления.Confirm that the bot has been deployed by checking the Notifications. Уведомление изменится с Развертывание выполняется... на Развертывание выполнено.The notifications will change from Deployment in progress... to Deployment succeeded. Щелкните ссылку Перейти к ресурсу , чтобы открыть страницу ресурсов Bot.Click Go to resource link to open the bot's resources page.

После создания бота проверьте его в компоненте "Веб-чат".Now that your bot is created, test it in Web Chat.

Тестирование ботаTest the bot

В разделе управления ботами щелкните Test in Web Chat (Тестирование в веб-чате).In the Bot Management section, click Test in Web Chat. Служба Azure Bot загрузит элемент управления "Веб-чат" и подключится к боту.Azure Bot Service will load the Web Chat control and connect to your bot.

тест Bot веб-приложения

Введите сообщение. Бот должен ответить.Enter a message and your bot should respond.

Регистрация приложений вручнуюManual app registration

Регистрацию вручную необходимо выполнять в таких ситуациях:A manual registration is necessary for situations like:

  • Вы не можете выполнить регистрацию в своей организации, и требуется третья сторона, чтобы создать идентификатор приложения для бота, сборка которого выполняется.You are unable to make the registrations in your organization and need another party to create the App ID for the bot you're building.
  • Вам нужно вручную создать свой идентификатор приложения (и пароль).You need to manually create your own app ID (and password).

Подробные сведения см. в разделе Регистрация приложения.See FAQ - App Registration.

Скачать кодDownload code

Можно скачать код, чтобы работать с ним локально.You can download the code to work on it locally.

  1. В разделе Bot Management (Управление ботами) щелкните Build (Выполнить сборку).In the Bot Management section, click Build.
  2. Щелкните ссылку Download Bot source code (Скачивание исходного кода бота) справа.Click on Download Bot source code link in the right-pane.
  3. Следуйте инструкциям на экране, чтобы скачать код, а затем распакуйте папку.Follow the prompts to download the code, and then unzip the folder.
    1. При скачивании бота вы сможете включить в файл все параметры (с ключами и секретами) своего бота, без которых, возможно, он не будет работать.When downloading your bot, you will be given the option to include the settings (containing the keys and secrets) for your bot in your download, which may be necessary for your bot to work. Если вы выберете Да, ключи будут содержаться в файле appsettings.json или .env.If you choose Yes, the appsettings.json or .env file will have the keys.

Дальнейшие действияNext steps

После скачивания кода вы можете продолжить разработку бота на своем локальном компьютере.After you download the code, you can continue to develop the bot locally on your machine. Как только вы протестируете бота и будете готовы отправить соответствующий код на портал Azure, выполните инструкции по настройке непрерывного развертывания, чтобы автоматически обновить код после внесения изменений.Once you test your bot and are ready to upload the bot code to the Azure portal, follow the instructions listed under set up continous deployment topic to automatically update code after you make changes.