Игровая площадка агентов Microsoft 365 для Visual Studio

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

На следующем рисунке показан пример приложения, отображающего ответ на тестовой площадке агентов:

Ниже приведены преимущества агента Playground.

• Песочница. Песочница на площадке агентов имитирует поведение, внешний вид и пользовательский интерфейс Teams.

• Туннелирование. Внешняя служба туннелирования не требуется, так как платформа агентов работает на локальном сервере, с которым бот может взаимодействовать.

• Уменьшение зависимостей учетных записей. Для отладки бота не требуется клиент разработчика Microsoft 365 и разрешения на отправку приложений.

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

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

• Надежность. Агентская площадка является надежной, так как адаптивная карточка бота использует ту же технологию отрисовки, что и в Teams.

• Интеграция с существующими приложениями ботов Teams. Платформа агентов легко интегрируется с существующими приложениями ботов Teams, созданными с помощью пакета SDK Bot Framework.

• Поддержка разных областей: агенты playground поддерживает тестирование в личных, командных и групповых чатах.

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

Убедитесь, что вы установили следующие средства для создания и развертывания бота на игровой площадке агентов:

Взаимодействие с тестовой площадкой агентов в Visual Studio

Агентская площадка обеспечивает более быструю отладку приложений ботов по сравнению с клиентом Teams. Агенты playground обеспечивает поддержку всех функций приложений бота. В этом сценарии в качестве примера мы используем бот чата ИИ . Чтобы выполнить отладку бота на агентской игровой площадке, выполните следующие действия.

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

2. Выберите Создать новый проект.

   

3. В поле поиска введите Microsoft Teams. В результатах поиска выберите Приложение Microsoft Teams.

4. Нажмите кнопку Далее.

   

5. Введите имя проекта и нажмите кнопку Создать.

   

6. Выберите Ai Chat BotCreate (Создание бота >чата СИ).

   Примечание.

   • OpenAI или Azure OpenAI являются необходимым условием для отладки приложения бота чата ИИ .

   

   Откроется окно GettingStarted.

   

7. Файл appsettings.Playground.json помогает настроить агентов Playground путем обновления нескольких параметров. Чтобы обновить appsettings.Playground.json файл, выполните действия OpenAI или Azure OpenAI:

   • OpenAI
   • Azure OpenAI

   Обновите OpenAI ApiKey в appsettings.Playground.json файле.

   

8. В раскрывающемся списке отладки выберите Microsoft 365 Agents Playground (браузер).

   

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

   

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

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

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

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

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

Предопределенные триггеры действий доступны в меню Макет действий на игровой площадке агентов. В этом сценарии в качестве примера используется триггер добавить действие пользователя . Чтобы имитировать действие add user , сделайте следующее:

1. В Visual Studio Code перейдите к Обозреватель решений.

2. Выберите файл Program.cs .

3. В файле Program.cs добавьте builder.Services.AddTransient<IBot>(sp => следующий код:

   app.OnConversationUpdate("membersAdded", async (context, state, cancellationToken) =>
   {
      await context.SendActivityAsync($"new member added", cancellationToken: cancellationToken);
   });
   

   Обработчик OnConversationUpdate распознает участников, присоединяющихся к диалогу, как описано в разделе Добавление действия пользователя.

   

4. На вкладке Агенты Playground перейдите в раздел Макет действия и выберите Добавить пользователя.

   

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

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

   

   Бот отправляет ответ.

   

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

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

1. В Visual Studio Code перейдите к Обозреватель решений.

2. Выберите файл Program.cs .

3. В файле Program.cs добавьте builder.Services.AddTransient<IBot>(sp => следующий код:

   app.OnMessageReactionsAdded(async (context, state, cancellationToken) =>
   {
      await context.SendActivityAsync($"reaction added.", cancellationToken: cancellationToken);
   });
   

   Обработчик OnMessageReactionsAdded определяет реакцию для добавления с помощью ReplyToId свойства предыдущего диалога.

   

4. Перейдите на веб-страницу Агентской площадки и выберите последний ответ на панели журналов, чтобы скопировать replyToId.

   

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

   

6. Чтобы настроить действие, добавьте messageReaction в type свойство .

7. Замените последней версией replyToId.

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

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

   

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

   

Ограничения

• Функции бота, включенные с помощью манифеста приложения, недоступны, так как платформа агентов не обрабатывает ее.

• Агентская площадка поддерживает не все типы карточек, кроме адаптивных карточек.

• На игровой площадке агентов не поддерживаются следующие функции адаптивной карточки:

  • Typeahead
  • Упоминание пользователя
  • Представление этапа
  • Полноширинная адаптивная карточка

• На тестовой площадке агентов не поддерживаются следующие возможности:

  • Мобильная версия
  • Собрание

См. также

• Обзор набора средств агентов Microsoft 365
• Создание ботов для Teams
• Адаптивная карточка
• Bot Framework SDK