Создание первого чат-бота для Microsoft Teams

Чат-бот выступает в качестве посредника между пользователем Teams и веб-службой. Пользователи могут общаться с ботом, чтобы быстро получить информацию, инициировать рабочие процессы или выполнить другие действия, предлагаемые веб-службой. Это руководство содержит сведения о том, как создать, запустить и развернуть чат-бота для Teams.

Подготовка к работе

Настройте среду разработки, установив необходимые компоненты.

Создание проекта

Используйте набор средств Teams для создания своего первого проекта.

  1. Откройте Visual Studio Code.

  2. Откройте набор средств Teams, выбрав значок Teams на боковой панели:

    Значок Teams на боковой панели Visual Studio Code .

  3. Выберите Создать проект.

    Расположение ссылки "Создать проект" на боковой панели набора средств Teams .

  4. Выберите Создать приложение Teams.

    Запуск мастера для создания нового проекта

  5. На этапе Выбор возможностей выберите Бот и снимите флажок рядом с пунктом Вкладка. Нажмите кнопку ОК.

    Снимок экрана: добавление возможностей в новое приложение.

  6. На этапе Регистрация бота выберите Создать новую регистрацию бота.

    Выбор создания новой регистрации бота

  7. На этапе Язык программирования выберите JavaScript.

    Снимок экрана: выбор языка.

  8. Выберите папку рабочей области. В папке рабочей области будет создана папка для создаваемого проекта.

  9. Введите подходящее имя для приложения, например helloworld. Имя приложения должно состоять только из букв и цифр. Чтобы продолжить, нажмите клавишу ВВОД.

Создание приложения Teams займет несколько секунд.

Знакомство с исходным кодом

Если вы хотите пропустить этот раздел, вы можете запустить приложение локально.

Расширение для сообщений использует Bot Framework, чтобы дать пользователю возможность взаимодействовать со службой посредством общения. После генерации кода проект будет выглядеть следующим образом:

Макет файла проекта бота.

Код бота хранится в каталоге bot. bots/teamsBot.js — основная точка входа для бота. Диалоги хранятся в каталоге dialogs.

Совет

Перед интеграцией своего первого бота в Teams ознакомьтесь с чат-ботами за пределами Teams. Дополнительные сведения о ботах см. в руководстве Служба Azure Bot.

Локальный запуск приложения

Набор средств Teams позволяет размещать приложение локально. Для этого:

  • Приложение Azure Active Directory регистрируется в клиенте M365.
  • Манифест приложения отправляется в Центр разработчиков для Teams.
  • API запускается локально с помощью Azure Functions Core Tools для поддержки приложения.
  • ngrok устанавливается и используется для обеспечения туннеля между Teams и кодом бота.

Чтобы создать и запустить приложение локально, выполните следующие действия.

  1. В Visual Studio Code нажмите клавишу F5, чтобы запустить приложение в режиме отладки.

    При первом запуске приложения произойдет загрузка всех зависимостей и сборка приложения. По завершении сборки автоматически откроется окно браузера. Для завершения может потребоваться от 3 до 5 минут.

  2. Веб-браузер начинает запускать приложение. Если вам будет предложено открыть Teams рабочий стол, выберите Отмена, чтобы оставаться в браузере. Вам также может быть предложено перейти на рабочий Teams в другое время; выберите Teams веб-приложение, когда это произойдет.

    Снимок экрана: выбор веб-версии Teams при запуске

  3. Вам может быть предложено выполнить вход. В этом случае войдите с учетной записью M365.

  4. При появлении запроса на установку приложения в Teams нажмите кнопку Добавить.

После загрузки приложения запустится сеанс общения с ботом. Вы можете ввести intro, чтобы просмотреть ознакомительную карточку, и show, чтобы просмотреть свои данные в Microsoft Graph. (Для этого потребуется утверждение дополнительных разрешений).

Отладка работает надлежащим образом — попробуйте сами! Откройте файл bot/dialogs/rootDialog.js и найдите метод triggerCommand(...). Задайте точку останова для варианта по умолчанию. Затем введите какой-нибудь текст.

Узнайте, что происходит при локальном запуске приложения в отладчике.

При нажатии клавиши F5 набор средств Teams:

  1. Зарегистрировал приложение в Azure Active Directory.
  2. Зарегистрировал приложение для установки неопубликованных приложений в Microsoft Teams.
  3. Запустил серверную часть приложения локально с помощью Azure Functions Core Tools.
  4. Запустил туннель ngrok, чтобы обеспечить взаимодействие Teams с вашим приложением.
  5. Запустил Microsoft Teams с помощью команды, обеспечивающей установку неопубликованного приложения в Teams.
Узнайте, как устранить распространенные проблемы при локальном запуске приложения.

Чтобы запустить приложение в Teams, у вас должна быть учетная запись разработчика Microsoft 365, позволяющая устанавливать неопубликованные приложения. Дополнительные сведения о создании учетной записи см. в разделе Необходимые компоненты.

Совет

Перед установкой неопубликованного приложения проверьте наличие проблем с помощью средства проверки приложений, которое входит в набор средств. Исправьте ошибки, чтобы успешно установить неопубликованное приложение.

Развертывание приложения в Azure

Развертывание состоит из двух этапов. Сначала создаются необходимые облачные ресурсы (также известные как подготовка), затем код, который составляет ваше приложение, копируется в созданные облачные ресурсы.

  1. Откройте Visual Studio Code.

  2. Выберите Teams набор средств на боковой панели, выбрав значок Teams.

  3. Выберите Положение в облаке.

    Снимок экрана, показывающий команды по подготовкам

  4. При необходимости выберите подписку для использования для ресурсов Azure.

    Примечание

    Для размещения приложения всегда используются некоторые ресурсы Azure.

  5. Диалоговое окно предупреждает, что при запуске ресурсов в Azure могут возникнуть затраты. Press Provision.

    Снимок экрана диалогового временного набора.

    Процесс подготовка создаст ресурсы в облаке Azure. Это займет некоторое время. Вы можете отслеживать ход, наблюдая за диалогами в правом нижнем углу. Через несколько минут вы увидите следующее уведомление:

    Снимок экрана, показывающий полный диалоговое окно подготовка.

  6. Как только подготовка завершена, выберите Развертывание в облаке. Как и в случае с подготовками, этот процесс занимает некоторое время. Вы можете отслеживать процесс, наблюдая диалоги в правом нижнем углу. Через несколько минут вы увидите уведомление о завершении.

Примечание

В чем разница между Provision и Deploy?

На шаге Provision будут создаваться ресурсы в Azure и M365 для вашего приложения, но код (HTML, CSS, JavaScript и т.д.) не копируется в ресурсы. Шаг Deploy скопирует код приложения на ресурсы, созданные во время шага по предоставлению. Часто развертывается несколько раз без предоставления новых ресурсов. Так как этап предоставления может занять некоторое время, он отделен от шага развертывания.

После завершения этапов подготовка и развертывание:

  1. С Visual Studio Code откройте панель отключки (Ctrl+Shift+D / ⌘⇧-D или Просмотр > Run)
  2. Выберите Пульт запуска (Edge) из выпадаемой конфигурации запуска.
  3. Нажмите кнопку Play, чтобы запустить приложение — теперь он работает удаленно из Azure!
Узнайте, что происходит после развертывания приложения в Azure

До развертывания приложение работает локально:

  1. Серверная часть работает с использованием Azure Functions Core Tools.
  2. Конечная точка HTTP приложения, в которую Microsoft Teams загружает приложение, работает локально.

Развертывание включает подготовку ресурсов для активной подписки Azure и развертывание (загрузку) внутреннего и внешнего кода приложения в Azure. Серверная часть использует различные службы Azure, включая службу приложений Azure и службу Azure Bot.

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

Узнайте о других методах создания приложений Teams: