Отладка бота чата ИИ с помощью средства тестирования приложений Teams
Запустите разработку приложений Microsoft Teams с помощью чат-бота Teams ИИ и выполните отладку с помощью средства тестирования приложений Teams (средства тестирования). Средство тестирования упрощает отладку приложений на основе ботов. Для использования средства тестирования не требуется учетная запись разработчика Microsoft 365, туннелирование или регистрация приложения Teams и бота.
Вы можете общаться с ботом и просматривать сообщения и адаптивные карточки по мере их появления в Teams. Вы также можете макетировать действие в средстве тестирования с помощью триггеров действий.
Примечание.
- Средство тестирования приложений Teams доступно только в Teams Toolkit версии 5.4.0.
- Средство тестирования приложений Teams поддерживается только для настольных и веб-клиентов.
Это пошаговое руководство поможет вам создать чат-бот ИИ с помощью набора средств Teams и выполнить отладку с помощью средства тестирования. После выполнения этого руководства вы увидите следующие выходные данные, в которых пользователь может получить доступ к боту чата ИИ и использовать его:
Предварительные условия
Установите следующие средства для создания и развертывания приложений.
| Установка | Для использования... |
|---|---|
| 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 | Браузера со средствами разработчика. |
Создание рабочей области проекта для приложения чат-бота ИИ
Давайте создадим приложение чат-бота ИИ.
Возможность бота в приложении Teams создает чат-бота или чат-бота. Он взаимодействует с веб-службой, облегчая использование ее служб. Бот может выполнять простые автоматизированные задачи, такие как обслуживание клиентов. Вы можете получить прогноз погоды, сделать резервирования или любую другую службу, предлагаемую с помощью бота для общения.
Как вы уже подготовились к созданию этих приложений, вы можете настроить новый проект Teams для создания приложения чат-бота ИИ. В этом руководстве вы узнаете:
Создание рабочей области проекта бота
Если предварительные требования выполнены, давайте начнем!
Откройте Visual Studio Code.
Щелкните значок Набора средств
Teams на панели действий Visual Studio Code.Выберите Создать приложение.
Выберите Бот.
Выберите AI Chat Bot. Если вам нужна другая функциональность для бота, выберите необходимый параметр.
Выберите JavaScript.
Выберите Папка по умолчанию.
Чтобы изменить расположение по умолчанию, выполните следующие действия.
Нажмите кнопку Обзор.
Выберите расположение рабочей области проекта.
Выберите Выбрать папку.
Введите подходящее имя для приложения, а затем нажмите клавишу ВВОД .
Появится диалоговое окно, в котором необходимо выбрать да или нет, чтобы доверять авторам файлов в этой папке.
Теперь вы успешно создали рабочую область проекта бота чата ИИ.
Обзор исходного кода приложения бота
После завершения формирования шаблонов изучите каталоги и файлы проектов в разделе EXPLORER Visual Studio Code.
| Имя папки или файла | Содержание |
|---|---|
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 действия, которые обеспечивают локальное выполнение и отладку в средстве тестирования. |
Создание и запуск приложения чат-бота ИИ
После настройки рабочей области проекта с помощью Набора средств Teams создайте проект чат-бота ИИ.
Создание ключа и конечной точки Open AI для бота чата ИИ
Перейдите к портал Azure.
Выберите Создать ресурс и найдите Azure Open AI.
Выберите Azure Open AI и нажмите Кнопку Создать.
Введите необходимые сведения и нажмите кнопку Далее.
Выберите Все сети, включая Интернет, могут получить доступ к этому ресурсу , а затем нажмите кнопку Далее.
Введите необходимые сведения и нажмите кнопку Далее.
Нажмите Создать.
Вы успешно создали ключ и конечную точку для чат-бота ИИ.
Примечание.
Вы также можете получить ключ API OpenAI для отладки бота чата ИИ. Дополнительные сведения см. в разделе Настройка ключа API.
Получение ключей и конечной точки Azure Open AI
Выберите Перейти к ресурсам.
Выберите Ключи и конечная точка в области слева и скопируйте ключ и конечную точку. Можно скопировать КЛЮЧ 1 или КЛЮЧ 2.
Сохраните КЛЮЧ и конечную точку для дальнейшего использования.
Выберите Развертывания моделей в области слева и выберите Управление развертываниями.
Откроется окно Azure Open AI Studio.
Выберите Развертывания в области слева и выберите + Создать новые развертывания.
Выберите следующие сведения:
- Выберите gpt-35-turbo в раскрывающемся списке Выберите модель .
Примечание.
Для чат-бота ИИ поддерживается только модель gpt-35-turbo .
- Выберите 0301 (по умолчанию) в раскрывающемся списке Версия модели .
- Введите имя развертывания и нажмите кнопку Создать.
- Выберите gpt-35-turbo в раскрывающемся списке Выберите модель .
Скопируйте и сохраните имя развертывания для дальнейшего использования.
Обновление ключа и конечных точек 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) и выберите Отладка в средстве тестирования (предварительная версия) в раскрывающемся списке.
Средство тестирования открывает чат-ботА ИИ на веб-странице.
Триггеры действий
Вы можете макетировать действие в средстве тестирования с помощью триггеров действий. Существует два типа триггеров действий:
Предопределенные триггеры действий
Средство тестирования предоставляет стандартные триггеры действий для проверки функциональных возможностей бота.
| Категория | Действие | Обработчик |
|---|---|---|
| Активация действия обновления установки | Установка бота Удаление бота |
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обработчик в ответ.
Выполнение задачи
Вы придумали такие выходные данные?
Поздравляем!
Вы успешно создали приложение чат-бота ИИ. Теперь вы научились отлаживать приложение чат-бота ИИ в средстве тестирования приложений Teams.
Возникла проблема с этим разделом? Если это так, отправьте нам отзыв, чтобы мы исправили этот раздел.
Platform Docs