Расширение расширения сообщений на основе бота в качестве агента для Microsoft 365 Copilot

Примечание.

• Убедитесь, что Microsoft 365 Copilot доступны для вашей организации. Вы можете получить среду разработчика для Microsoft 365 Copilot двумя способами:
  • Клиент песочницы Microsoft 365 с Microsoft 365 Copilot (доступна в ограниченной предварительной версии через членство в TAP).
  • Рабочая среда Microsoft 365 или Office 365 с лицензией на Microsoft 365 Copilot.
• Агент расширения сообщений поиска на основе бота доступен в общедоступной предварительной версии для разработчиков.
• Только расширения сообщений на основе бота с командами поиска могут быть расширены в качестве агентов для Microsoft 365 Copilot.

Microsoft 365 Copilot на базе расширенной подсистемы обработки и оркестрации интегрирует приложения Microsoft 365, Microsoft Graph и большие языковые модели (LLM), чтобы превратить ваши слова в мощный инструмент для повышения производительности. Хотя Microsoft 365 Copilot могут использовать приложения и данные в экосистеме Microsoft 365, многие пользователи используют различные внешние инструменты и службы для управления работой и совместной работы. Расширив расширение сообщений в качестве агента в Microsoft 365 Copilot, вы можете позволить пользователям взаимодействовать со сторонними средствами и службами, что позволяет им достичь большего с помощью Microsoft 365 Copilot. Это расширение можно реализовать путем разработки агента или подключения к внешнему источнику данных.

Что такое агент?

Агент позволяет Microsoft 365 Copilot напрямую взаимодействовать со сторонними данными, приложениями и службами, расширять свои возможности и расширять спектр возможностей. Агенты позволяют Microsoft 365 Copilot:

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

Описания повышают удобство использования и эффективность агента расширения сообщений. В следующем описании представлена четкая и краткая сводка функций приложения:

• Описание приложения. Описание приложения помогает улучшить возможности обнаружения приложений в Магазине Teams.
• Описание команды. Описание команды сопоставляет намерение пользователя и речевой фрагмент с поисковой командой внутри агента и должна быть построена на основе анализа намерения пользователя и ключевых слов.
• Описание параметра. Описание параметра объясняет требования системы на естественном языке с форматом вывода.
• Семантическое описание. Семаническое описание помогает Microsoft 365 Copilot создавать содержимое, предоставляя концептуальное представление о возможностях и сценариях агента, в которых оно может помочь достичь целей пользователя и сопоставить намерение пользователя с возможностями агента.

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

Все расширения поисковых сообщений на основе ботов, которые имеют право на поддержку агентов, должны соответствовать требованиям политики и подлежат проверке, чтобы убедиться, что агент соответствует ожиданиям качества, безопасности, конфиденциальности и полезности. Вы можете создать расширение для поиска сообщений на основе бота с помощью набора средств Teams для Visual Studio Code, Visual Studio, интерфейса командной строки набора средств Teams (CLI) или портала разработчика для Teams и расширить расширение сообщений для работы в качестве агента в Microsoft 365 Copilot.

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

Прежде чем приступить к работе, ознакомьтесь со следующими стандартами и рекомендациями по созданию агентов расширения сообщений для Microsoft 365 Copilot:

• Стандарты соответствия требованиям, производительности, безопасности и взаимодействия с пользователем, описанные в рекомендациях по проверке Магазина Teams.

• Рекомендации по созданию или обновлению агента расширения сообщений для Microsoft 365 Copilot.

Создание расширения сообщений на основе бота

Важно!

Агенты для Microsoft 365 Copilot находятся в предварительной версии и работают только в Microsoft 365 Copilot в Teams.

Давайте создадим агент расширения сообщений поиска на основе бота для Teams и Microsoft 365 Copilot и поделиться результатами через область создания сообщений клиента Microsoft Teams.

Visual Studio Code

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

• Установите последнюю предварительную версию набора средств Teams.
• Убедитесь, что флаг функции Разработка подключаемого модуля Copilot включен. Чтобы включить флаг функции, выполните следующие действия.
  1. Откройте Visual Studio Code.
  2. Перейдите в раздел Управление>параметрами.
  3. В поле поиска параметров поиска введите Набор средств Teams.
  4. В разделе Расширения установите флажок Fx-extension: Develop Copilot Plugin (Расширения Fx-extension: Разработка подключаемого модуля Copilot ).

Чтобы создать агент расширения сообщений поиска на основе бота с помощью Visual Studio Code, выполните следующие действия.

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

2. В левой области выберите Набор средств Teams.

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

4. Выберите Расширение сообщений.

5. Выберите Настраиваемые результаты поиска.

6. Выберите Начать с бота.

   

7. Выберите язык программирования.

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

9. Введите имя приложения и нажмите клавишу ВВОД. Набор средств Teams формирует шаблон приложения и создает расширение для сообщений.

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

1. В левой области выберите Набор средств Teams.

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

   1. Выберите Войти в Microsoft 365 и введите учетные данные Microsoft 365.

   2. Выберите Войти в Azure и введите учетные данные Azure.

      

3. В левой области выберите Выполнить и отладить (CTRL+SHIFT+D).

4. Выберите Отладка в Teams (Edge) или Отладка в Teams (Chrome) . Teams Toolkit запускает приложение в Teams с помощью веб-браузера.

5. Нажмите Добавить. Приложение устанавливается в Teams.

6. Перейдите в чат и выберите Действия и приложения.

7. Во всплывающем меню расширения сообщений введите имя расширения сообщения в поле поиска.

8. Выберите расширение сообщений и введите поисковый запрос.

9. Выберите продукт из списка. Teams развертывает продукт в виде адаптивной карточки в области создания сообщения.

10. Нажмите кнопку Отправить.

Активация расширения сообщений в Microsoft 365 Copilot

Чтобы активировать расширение сообщений в качестве агента в Microsoft 365 Copilot в Teams, выполните следующие действия:

1. Выберите Приложения.

2. Найдите Copilot и откройте Microsoft 365 Copilot.

3. Выберите Панель в правом верхнем углу.

4. Выберите необходимый агент в правой области.

   

5. В области создания сообщений отправьте сообщение в Microsoft 365 Copilot, чтобы найти последнее обновление в Teams и Microsoft 365 Copilot.

   

Примечание.

Этот запрос может не всегда гарантировать ответ от расширения сообщений в Microsoft 365 Copilot. В этом случае попробуйте другие запросы или предоставьте отзыв, понизив Microsoft 365 Copilot ответ и оставив сообщение.

Visual Studio

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

• Установите Visual Studio Enterprise 2022 preview версии 17.9.0 preview 1.0 или более поздней версии и установите средства разработки Microsoft Teams в рабочей нагрузке ASP.NET и веб-разработка.
• Убедитесь, что флаг функции Copilot включен. Чтобы включить флаг функции, выполните следующие действия.
  1. Откройте Visual Studio.
  2. Перейдите враздел Параметрыинструментов>.
  3. В поле поиска параметров поиска введите Набор средств Teams.
  4. В разделе Предварительные версии функций установите флажок Набор средств Teams: Разработка подключаемого модуля Copilot .
• Убедитесь, что включен профиль запуска нескольких проектов. Чтобы включить профиль, выполните следующие действия.
  1. Откройте Visual Studio.
  2. Перейдите враздел Параметрыинструментов>.
  3. В разделе Предварительные версии функций установите флажок Включить профили запуска нескольких проектов .

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

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

2. Перейдите в раздел Файл>новый>проект... или Создать новый проект.

3. Найдите Teams и выберите Приложение Microsoft Teams.

4. Введите сведения о проекте. Убедитесь, что флажок Разместить решение и проект в одном каталоге не установлен.

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

6. Выберите Настраиваемые результаты поиска.

   

7. Нажмите Создать. Проект является шаблонным.

8. В раскрывающемся меню отладки выберите Dev Tunnels>Create a Tunnel (Создание туннеля).

   
   

   1. Выберите учетную запись, чтобы создать туннель. Поддерживаемые типы учетных записей — это Azure, учетная запись Майкрософт (MSA) и GitHub .
   2. Имя. Введите имя туннеля.
   3. Тип туннеля: выберите Постоянный или Временный.
   4. Доступ: выберите Общедоступный.
   5. Нажмите OK. Visual Studio отображает сообщение с подтверждением создания туннеля.

   Созданный туннель отображается в разделе Dev Tunnels > (имя туннеля).

9. Перейдите в Обозреватель решений и выберите свой проект.

10. Щелкните правой кнопкой мыши меню проекта и выберите Teams Toolkit>Prepare Teams App Dependencies (Подготовка зависимостей приложений Teams).

    

    При появлении запроса войдите с помощью учетной записи Microsoft 365.

11. В раскрывающемся меню отладки выберите Microsoft Teams (браузер). Visual Studio запускает веб-клиент Teams.

12. Нажмите Добавить. Расширение сообщений добавляется в Teams.

    

13. Перейдите в чат и выберите Действия и приложения.

14. Во всплывающем меню расширения сообщений введите имя расширения сообщения в поле поиска.

15. Выберите расширение сообщений и введите поисковый запрос.

    

16. Выберите продукт из списка. Teams разворачивает продукт в адаптивную карточку в области создания сообщения.

17. Нажмите кнопку Отправить. Адаптивная карточка отправляется в чат.

    

Активация расширения сообщений в Microsoft 365 Copilot

Чтобы активировать расширение сообщений в качестве агента в Microsoft 365 Copilot, выполните следующие действия.

1. Перейдите в Visual Studio.

2. В раскрывающемся списке отладки выберите Copilot (браузер). Visual Studio запускает веб-клиент Teams.

   

3. Перейдите в раздел Веб-клиентские>приложения Teams.

4. Найдите Copilot и откройте Microsoft 365 Copilot.

5. Выберите Панель в правом верхнем углу.

6. Выберите необходимый агент в правой области.

   

7. В области создания сообщений отправьте сообщение в Microsoft 365 Copilot, чтобы найти последнее обновление в Teams и Microsoft 365 Copilot.

   

Примечание.

Этот запрос может не всегда гарантировать ответ от расширения сообщений в Microsoft 365 Copilot. В этом случае попробуйте другие запросы или предоставьте отзыв, понизив Microsoft 365 Copilot ответ и оставив сообщение.

Интерфейс командной строки набора средств

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

1. На компьютере выберите клавишу Windows + X .

2. Выберите Система.

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

4. В разделе Свойства системы выберите Переменные среды...

5. В разделе Переменные пользователя выберите Создать... Откроется диалоговое окно Новая переменная пользователя .

6. Обновите следующие поля:

   1. Имя переменной: DEVELOP_COPILOT_PLUGIN
   2. Значение переменной: true

7. Нажмите OK.

   

Чтобы создать агент расширения сообщений поиска на основе бота с помощью Teams Toolkit CLI, выполните следующие действия.

1. Перейдите в командную строку.

2. Введите следующую команду:

   npm install -g @microsoft/teamsapp-cli
   

3. Введите teamsapp new в терминале.

4. Выберите Расширение сообщений. Используйте клавиши со стрелками для переключения между параметрами.

   

5. Выберите Настраиваемые результаты поиска.

6. Выберите Начать с бота.

   

7. Введите расположение проекта и нажмите клавишу ВВОД.

8. Введите имя приложения и нажмите клавишу ВВОД.

   Набор средств Teams создает шаблон и создает проект в указанном расположении.

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

    teamsapp provision --env dev
   

   Teams Toolkit CLI открывает окно браузера и запрашивает вход в учетную запись Майкрософт.

10. Войдите в свою учетную запись Майкрософт. Teams Toolkit CLI выполняет проверку и подготавливает приложение в Azure.

11. В списке выберите подписку.

    

12. В списке выберите группу ресурсов.

13. Если вы получаете сообщение, в котором сказано, что затраты могут нести в соответствии с использованием. Вы хотите подготовить ресурсы в среде разработки с помощью учетных записей, перечисленных выше?, введите Y.

    

    Набор средств Teams проверяет манифест приложения и подготавливает приложение в Azure.

14. В окне командной строки введите следующую команду, чтобы просмотреть приложение в Teams:

     teamsapp preview --env dev
    

    Откроется новое окно браузера с веб-клиентом Teams. Вы можете добавить приложение в Teams.

15. Нажмите Добавить. Расширение сообщений добавляется в Teams.

16. Перейдите в чат и выберите Действия и приложения.

17. Во всплывающем меню расширения сообщений введите имя расширения сообщения в поле поиска.

18. Выберите расширение сообщений и введите поисковый запрос.

Активация расширения сообщений в Microsoft 365 Copilot

Чтобы активировать расширение сообщений в качестве агента в Microsoft 365 Copilot в Teams, выполните следующие действия:

1. Выберите Приложения.

2. Найдите Copilot и откройте Microsoft 365 Copilot.

3. Выберите Панель в правом верхнем углу.

4. Выберите необходимый агент в правой области.

   

5. В области создания сообщений отправьте сообщение в Microsoft 365 Copilot, чтобы найти последнее обновление в Teams и Microsoft 365 Copilot.

   

Примечание.

Этот запрос может не всегда гарантировать ответ от расширения сообщений в Microsoft 365 Copilot. В этом случае попробуйте другие запросы или предоставьте отзыв, понизив Microsoft 365 Copilot ответ и оставив сообщение.

Портал разработчика Teams

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

1. Перейдите на портал разработчика для Teams.

2. Перейдите в раздел Приложения.

3. Выберите + Новые приложения.

4. На странице Добавление приложений обновите имя и выберите версию манифеста в качестве общедоступной предварительной версии разработчика (devPreview).

   

5. В разделе Настройка выберите Функции приложений.

6. Выберите Расширение для обмена сообщениями.

7. В разделе Тип расширения сообщения выберите Бот.

   1. Если вы получаете заявление об отказе от ответственности, которое считывает расширение API Message, уже используется пользователями. Вы хотите изменить тип расширения сообщений на bot?. Выберите Да, изменить.

      

8. Если у вас есть бот, выберите Существующий бот или, если у вас есть идентификатор бота, выберите Ввести идентификатор бота.

   1. Если у вас нет идентификатора бота, можно выбрать Создать бот, чтобы создать бот и ввести идентификатор созданного бота.

      

9. Выберите Сохранить.

10. В разделе Команда выберите + Добавить команду.

    Откроется страница добавления команды.

11. На странице Добавление команды выберите тип команды Поиск и обновите следующие поля:

    • Идентификатор команды
    • Заголовок команды
    • Описание команды
    • Контекст, в котором работает команда
    • Имя параметра
    • Заголовок параметра
    • Описание параметра

12. Выберите Сохранить. Команда добавляется в расширение сообщения.

13. Выберите Сохранить.

Создается расширение сообщений поиска на основе бота.

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

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

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

Дополнительные сведения о тестировании агента в Microsoft 365 Copilot см. в разделе Выбор агента отладки.

Пошаговые инструкции

Следуйте инструкциям в пошаговом руководстве по созданию агента расширения сообщений поиска на основе бота для Microsoft 365 Copilot.

См. также

• Создание расширений сообщений с помощью API
• Определение команд действий расширения для сообщений
• Расширение Microsoft 365 Copilot
• Часто задаваемые вопросы об агенте для Microsoft 365 Copilot