Отладка бота чата ИИ с помощью средства тестирования приложений Teams

Статья
Developer (Продвинутый уровень)
7 мин до завершения

Запустите разработку приложений Microsoft Teams с помощью чат-бота Teams ИИ и выполните отладку с помощью средства тестирования приложений Teams (средства тестирования). Средство тестирования упрощает отладку приложений на основе ботов. Для использования средства тестирования не требуется учетная запись разработчика Microsoft 365, туннелирование или регистрация приложения Teams и бота.

Вы можете общаться с ботом и просматривать сообщения и адаптивные карточки по мере их появления в Teams. Вы также можете макетировать действие в средстве тестирования с помощью триггеров действий.

Примечание.

Средство тестирования приложений Teams доступно только в Teams Toolkit версии 5.4.0.
Средство тестирования приложений Teams поддерживается только для настольных и веб-клиентов.

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

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

Осталось 6 мин

Установите следующие средства для создания и развертывания приложений.

Установка	Для использования...
Visual Studio Code или Visual Studio	Среды сборки JavaScript, TypeScript или C#. Используйте последнюю версию.
Набор средств Teams	Расширение Microsoft Visual Studio Code, которое создает шаблон проекта для вашего приложения. Используйте Набор средств Teams версии 5.4.0. Дополнительные сведения см. в разделе Установка Набора средств Teams.
Node.js	Серверной среды выполнения JavaScript. Дополнительные сведения см . вNode.js таблице совместимости версий для типа проекта.
OpenAI или Azure OpenAI	Сначала создайте ключ API OpenAI, чтобы использовать GPT OpenAI. Если вы хотите разместить приложение или получить доступ к ресурсам в Azure, необходимо создать службу Azure OpenAI.
Microsoft Edge (рекомендуется) или Google Chrome	Браузера со средствами разработчика.

Создание рабочей области проекта для приложения чат-бота ИИ

Осталось 5 мин

Давайте создадим приложение чат-бота ИИ.

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

Снимок экрана: приложение с тремя функциями. Бот выделен.

Как вы уже подготовились к созданию этих приложений, вы можете настроить новый проект Teams для создания приложения чат-бота ИИ. В этом руководстве вы узнаете:

Создайте рабочую область проекта бота.
Ознакомьтесь с исходным кодом приложения бота.

Создание рабочей области проекта бота

Если предварительные требования выполнены, давайте начнем!

Откройте Visual Studio Code.
Щелкните значок Набора средств Teams на панели действий Visual Studio Code.
Выберите Создать приложение.
Выберите Бот.
Выберите AI Chat Bot. Если вам нужна другая функциональность для бота, выберите необходимый параметр.
Выберите JavaScript.
Выберите Папка по умолчанию.

Чтобы изменить расположение по умолчанию, выполните следующие действия.
1. Нажмите кнопку Обзор.
2. Выберите расположение рабочей области проекта.
3. Выберите Выбрать папку.
4. Введите подходящее имя для приложения, а затем нажмите клавишу ВВОД .
  
  Появится диалоговое окно, в котором необходимо выбрать да или нет, чтобы доверять авторам файлов в этой папке.
  
  Теперь вы успешно создали рабочую область проекта бота чата ИИ.

Обзор исходного кода приложения бота

После завершения формирования шаблонов изучите каталоги и файлы проектов в разделе EXPLORER Visual Studio Code.

Снимок экрана: структура папки бота с примером набора средств Teams.

Имя папки или файла	Содержание
`env/.env.testtool`	Файл конфигурации с переменными среды, которые можно зафиксировать в Git.
`env/.env.testtool.user`	Файл конфигурации с переменными среды, включая учетные данные, которые не зафиксированы в Git по умолчанию.
`appPackage`	Файлы шаблонов манифеста приложения и значки приложений (color.png и outline.png).
`appPackage/manifest.json`	Манифест приложения для запуска приложения в локальной и удаленной среде.
`src/app.js`	Обрабатывает бизнес-логику чат-бота ИИ.
`teamsapp.yml`	Это файл проекта набора средств Teams main. Файл проекта определяет два основных элемента: свойства и конфигурацию и определения этапов.
`teamsapp.local.yml`	Это переопределяет `teamsapp.yml` действия, которые обеспечивают локальное выполнение и отладку.
`teamsapp.testtool.yml`	Это переопределяет `teamsapp.yml` действия, которые обеспечивают локальное выполнение и отладку в средстве тестирования.

Создание и запуск приложения чат-бота ИИ

Осталось 4 мин

После настройки рабочей области проекта с помощью Набора средств Teams создайте проект чат-бота ИИ.

Создание ключа и конечной точки Open AI для бота чата ИИ

Перейдите к портал Azure.
Выберите Создать ресурс и найдите Azure Open AI.
Выберите Azure Open AI и нажмите Кнопку Создать.
Введите необходимые сведения и нажмите кнопку Далее.
Выберите Все сети, включая Интернет, могут получить доступ к этому ресурсу , а затем нажмите кнопку Далее.
Введите необходимые сведения и нажмите кнопку Далее.
Нажмите Создать.

Вы успешно создали ключ и конечную точку для чат-бота ИИ.

Примечание.

Вы также можете получить ключ API OpenAI для отладки бота чата ИИ. Дополнительные сведения см. в разделе Настройка ключа API.

Получение ключей и конечной точки Azure Open AI

Выберите Перейти к ресурсам.
Выберите Ключи и конечная точка в области слева и скопируйте ключ и конечную точку. Можно скопировать КЛЮЧ 1 или КЛЮЧ 2.

Сохраните КЛЮЧ и конечную точку для дальнейшего использования.
Выберите Развертывания моделей в области слева и выберите Управление развертываниями.

Откроется окно Azure Open AI Studio.
Выберите Развертывания в области слева и выберите + Создать новые развертывания.
Выберите следующие сведения:
1. Выберите gpt-35-turbo в раскрывающемся списке Выберите модель .
  
  Примечание.
  
  Для чат-бота ИИ поддерживается только модель gpt-35-turbo .
2. Выберите 0301 (по умолчанию) в раскрывающемся списке Версия модели .
3. Введите имя развертывания и нажмите кнопку Создать.
Скопируйте и сохраните имя развертывания для дальнейшего использования.

Обновление ключа и конечных точек Azure Open AI

Откройте проект в Visual Studio Code.
В разделе EXPLORER перейдите к файлу env.env.testtool.user>.

Введите SECRET_AZURE_OPENAI_API_KEY и SECRET_AZURE_OPENAI_ENDPOINT.

...
SECRET_AZURE_OPENAI_API_KEY=<azure-openai-api-key>
SECRET_AZURE_OPENAI_ENDPOINT=<azure-openai-endpoint>

Перейдите в файл app.jssrc>.
Закомментируйте OpenAI код и раскомментируйте Azure OpenAI его.

Введите имя развертывания Azure Open AI в поле azureDefaultDeployment.

...
// Use OpenAI
// apiKey: config.openAIKey,
// defaultModel: "gpt-3.5-turbo",

azureApiKey: config.azureOpenAIKey,
azureDefaultDeployment: "gpt-35-turbo",
azureEndpoint: config.azureOpenAIEndpoint,
...

Отладка и запуск приложения чат-бота ИИ

В левой области выберите ВЫПОЛНИТЬ и ОТЛАДКА (CTRL+SHIFT+D) и выберите Отладка в средстве тестирования (предварительная версия) в раскрывающемся списке.
Средство тестирования открывает чат-ботА ИИ на веб-странице.

Триггеры действий

Осталось 3 мин

Вы можете макетировать действие в средстве тестирования с помощью триггеров действий. Существует два типа триггеров действий:

Предопределенные триггеры действий
Триггеры пользовательских действий

Предопределенные триггеры действий

Средство тестирования предоставляет стандартные триггеры действий для проверки функциональных возможностей бота.

Категория	Действие	Обработчик
Активация действия обновления установки	Установка бота Удаление бота	`onInstallationUpdate` `onInstallationUpdateAdded` `onInstallationUpdate` `onInstallationUpdateRemove`
Активация действия обновления беседы	Добавление пользователя Добавление бота Добавление канала	`onMembersAdded` `onTeamsMembersAddedEvent` `onMembersAdded` `onTeamsMembersAddedEvent` `onTeamsChannelCreatedEvent`
	Удаление пользователя Удаление бота Удаление канала Удаление команды	`onMembersRemoved` `onTeamsMembersRemovedEvent` `onMembersRemoved` `onTeamsMembersRemovedEvent` `onTeamsChannelDeletedEvent` `onTeamsTeamDeletedEvent`
	Переименование канала Переименование команды	`onTeamsChannelRenamedEvent` `onTeamsTeamRenamedEvent`

Примечание.

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

Предопределенные триггеры действий доступны в меню Макет действия в средстве тестирования.

Чтобы имитировать действие add user , сделайте следующее:

В средстве тестирования выберите Макет действия>Добавить пользователя.

Появится диалоговое окно для предварительного просмотра обработчика действий.
Выберите Отправить действие.

Бот отправляет следующий ответ:

Триггеры пользовательских действий

Настраиваемое действие можно использовать для настройки триггеров действий, например reactionsAdded в соответствии с требованиями приложения бота. Средство тестирования автоматически заполняет необходимые свойства действия. Вы также можете изменить тип действия и добавить дополнительные свойства.

Выберите Макет пользовательского>действия действия.

Добавьте messageReaction для настройки действия в свойстве type :

{
  "type": "messageReaction",
  "reactionsAdded": [
    {
      "type": "like"
    }
  ],
  "replyToId": "d60fd1cb-3e8f-44ef-849c-404806ba1b47"
}

Выберите Отправить действие.

Бот отправляет onReactionsAdded обработчик в ответ.