Отладка бота чата ИИ с помощью игровой площадки агентов Microsoft 365

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. Щелкните значок Microsoft 365 Agents Toolkit (Набор средств microsoft 365 Agents Toolkit) на панели действий Visual Studio Code.

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

   

4. Выбор агентов для Teams

   

5. Выберите Базовые агенты для Teams. Если вам нужна другая функциональность для бота, выберите необходимый параметр.

   

6. Выберите Azure OpenAI>Входной ключ службы API Azure сейчас. JavaScript.

   

7. Выберите Папка по умолчанию.

   

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

   1. Нажмите кнопку Обзор.

      

   2. Выберите расположение рабочей области проекта.

   3. Выберите Выбрать папку.

      

   4. Введите подходящее имя для приложения, а затем нажмите клавишу ВВОД .

      

      Появится диалоговое окно, в котором необходимо выбрать да или нет, чтобы доверять авторам файлов в этой папке.

      

      Теперь вы успешно создали рабочую область проекта бота чата ИИ.

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

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

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

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

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

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

1. Перейдите к портал Azure.

2. Выберите Создать ресурс и найдите Azure Open AI.

3. Выберите Azure Open AI и нажмите Кнопку Создать.

   

4. Введите необходимые сведения и нажмите кнопку Далее.

   

5. Выберите Все сети, включая Интернет, могут получить доступ к этому ресурсу , а затем нажмите кнопку Далее.

   

6. Введите необходимые сведения и нажмите кнопку Далее.

   

7. Нажмите Создать.

   

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

   

   Примечание.

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

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

1. Выберите Перейти к ресурсам.

   

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

   

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

3. Выберите Развертывания моделей в области слева и выберите Управление развертываниями.

   

   Откроется окно Azure Open AI Studio.

4. Выберите Развертывания в области слева и выберите + Создать новые развертывания.

   

5. Выберите следующие сведения:

   1. Выберите gpt-35-turbo в раскрывающемся списке Выберите модель .

      Примечание.

      Для чат-бота ИИ поддерживается только модель gpt-35-turbo .

   2. Выберите 0301 (по умолчанию) в раскрывающемся списке Версия модели .
   3. Введите имя развертывания и нажмите кнопку Создать.

   

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

   

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

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

2. В разделе ПРОВОДНИК перейдите к файлу env.env.playground.user>.

3. Введите 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>
   

4. Перейдите в файл app.jssrc>.

5. Закомментируйте OpenAI код и раскомментируйте Azure OpenAI его.

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

   ...
   // Use OpenAI
   // apiKey: config.openAIKey,
   // defaultModel: "gpt-3.5-turbo",
   
   azureApiKey: config.azureOpenAIKey,
   azureDefaultDeployment: "gpt-35-turbo",
   azureEndpoint: config.azureOpenAIEndpoint,
   ...
   

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

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

   

2. Агенты Playground открывает чат-бот ИИ на веб-странице.

   

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

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

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

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

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

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

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

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

1. На вкладке Агенты Playground выберите Mock an Activity> Add user (Макет действияДобавить пользователя).

   

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

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

   

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

   

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

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

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

   

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

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

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

   

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

   

Выполнение задачи

• Осталось 2 мин

Вы придумали такие выходные данные?

Поздравляем!

• 100% завершено

Вы успешно создали приложение чат-бота ИИ. Теперь вы научились отлаживать приложение бота чата ИИ на детской площадке агентов.