Создание ботаCreate a bot

Важно!

Статьи, приведенные в этом разделе, основаны на пакете SDK "V3 Bot Framework".The articles in this section are based on the v3 Bot Framework SDK. Если вы ищете текущую документацию (версия 4,6 или более поздняя версия пакета SDK), ознакомьтесь с разделом " беседы Боты ".If you're looking for current documentation (version 4.6 or later of the SDK) see the Conversational Bots section.

Все боты, созданные с помощью Microsoft Bot Framework, настроены и готовы к работе в Microsoft Teams.All bots created using the Microsoft Bot Framework are configured and ready to work in Microsoft Teams.

Общие сведения о боты можно найти в документации по среде Bot .See the Bot Framework Documentation for general information on bots.

Создание бота для Microsoft TeamsCreate a bot for Microsoft Teams

Приложение Teams Studio — это средство, которое поможет вам создать робота и пакет приложения, ссылающийся на робот.Teams App Studio is a tool that can help create your bot, and an app package that references your bot. Оно также содержит библиотеку элементов управления React и настраиваемые примеры для карточек.It also contains a React control library and configurable samples for cards. См. статью Начало работы с Teams App Studio.See Getting started with Teams App Studio. В приведенных ниже действиях предполагается, что вы настраиваете Bot и не используете приложение Teams Studio.The steps that follow assume that you are hand configuring your bot and not using Teams App Studio.

  1. Создайте Bot с помощью этой ссылки: https://dev.botframework.com/bots/new.Create the bot using this link: https://dev.botframework.com/bots/new. После создания бота обязательно добавьте Microsoft Teams в виде канала из списка основных каналов.Be sure to add Microsoft Teams as a channel from the featured channels list after creating your bot. Вы можете повторно использовать любой сгенерированный вами идентификатор приложения Майкрософт, если вы уже создали пакет или манифест приложения.Feel free to re-use any Microsoft App ID you generated if you've already created your app package/manifest.

    Страница регистрации в Bot Framework

Примечание

Если вы не хотите создавать Bot в Azure, вы должны использовать эту ссылку для создания новой ленты: https://dev.botframework.com/bots/new.If you do not wish to create your bot in Azure, you must use this link to create a new bot: https://dev.botframework.com/bots/new. При нажатии кнопки создать на портале Bot Framework вместо этого вы создадите робот в Microsoft Azure .If you click on the Create a bot button in the Bot Framework portal instead, you will create your bot in Microsoft Azure instead.

  1. Создайте Bot с помощью пакета NuGet Microsoft. Bot. Connector. Teams , пакета SDK для Bot Frameworkили API соединителя Bot.Build the bot using the Microsoft.Bot.Connector.Teams NuGet package, the Bot Framework SDK, or the Bot Connector API. В этой статье также приведены примеры кода Bot Framework.See also Bot Framework samples.

  2. Протестируйте Bot с помощью эмулятора Bot Framework.Test the bot using the Bot Framework Emulator.

  3. Развертывание ленты в облачной службе, такой как Microsoft Azure.Deploy the bot to a cloud service, such as Microsoft Azure. Кроме того, запустите свое приложение на локальном компьютере и используйте службу туннелирования, например, ngrok для предоставления конечной точки HTTPS://для ленты https://45az0eb1.ngrok.io/api/messages, например.Alternatively, run your app locally and use a tunneling service such ngrok to expose an https:// endpoint for your bot, such as https://45az0eb1.ngrok.io/api/messages.

Примечание

Боты и Microsoft AzureBots and Microsoft Azure

На декабрь 2017, портал Bot Framework оптимизирован для регистрации боты в Microsoft Azure.As of December, 2017, the Bot Framework portal is optimized for registering bots in Microsoft Azure. Вот некоторые моменты, которые следует знать:Here are some things to know:

  • Каналы Microsoft Teams для ботов, зарегистрированных в Azure, являются бесплатными.The Microsoft Teams channel for bots registered on Azure is free. Сообщения, отправляемые по каналу Teams, не будут подсчитываться до использованных сообщений для Bot.Messages sent over the Teams channel will not count towards the consumed messages for the bot.
  • Несмотря на то, что вы можете создать новый элемент ленты Bot, не используя Azure, необходимо использовать этот URLhttps://dev.botframework.com/bots/new)-адрес (который больше не отображается на портале Bot Framework).While it's possible to create a new Bot Framework bot without using Azure, you must use that URL (https://dev.botframework.com/bots/new), which is no longer exposed in the Bot Framework portal.
  • При изменении свойств существующего элемента Bot в списке боты в Bot Framework , например "конечная точка для обмена сообщениями", которая является распространенной при первой разработке ленты, особенно при использовании ngrok, появится столбец "состояние миграции" и синяя кнопка "переносить", которая попытается перейти на портал Microsoft Azure.When you edit the properties of an existing bot in the list of your bots in Bot Framework such as its "messaging endpoint," which is common when first developing a bot, especially if you use ngrok, you will see "Migration status" column and a blue "Migrate" button that will take you into the Microsoft Azure portal. Не нажимайте кнопку "переносить", пока не хотите делать это. Вместо этого щелкните имя Bot и вы можете изменить его свойства:Don't click on the "Migrate" button unless that's what you want to do; instead, click on the name of the bot and you can edit its properties:
    Изменение свойств ботаEdit Bot Properties
  • Если вы зарегистрировали программу Bot с помощью Microsoft Azure, код для ленты не должен размещаться в Microsoft Azure.If you register your bot using Microsoft Azure, your bot code does not need to be hosted on Microsoft Azure.
  • Если вы зарегистрировали бота с помощью портала Microsoft Azure, у вас должна быть учетная запись Microsoft Azure.If you do register a bot using Microsoft Azure portal, you must have a Microsoft Azure account. Вы можете создать ее бесплатно.You can create one for free. Чтобы проверить удостоверение при создании, необходимо предоставить кредитную карту, но она не будет взиматься; Вы всегда можете создавать и использовать боты в Microsoft Teams.To verify your identity when you create one, you must provide a credit card, but it won't be charged; it's always free to create and use bots with Microsoft Teams.
  • Теперь вы можете использовать приложение App Studio для регистрации и обновления сведений о приложении и Bot непосредственно в Microsoft Teams.You can now use App Studio to register/update app and bot information directly within Microsoft Teams. Вам потребуется использовать портал Microsoft Azure для добавления и настройки других каналов ленты, таких как прямые линии, Интернет-чат, Skype и Facebook Messenger.You'll only have to use the Microsoft Azure portal for adding/configuring other Bot Framework channels such as Direct Line, Web Chat, Skype, and Facebook Messenger.