Расширение расширения сообщений на основе бота в качестве подключаемого модуля для 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 Teams см. в этом видео:

Что такое подключаемый модуль?

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

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

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

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

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

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

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

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

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

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

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

Важно!

Подключаемые модули для Microsoft 365 Copilot доступны в предварительной версии и работают только в Microsoft 365 Copilot в Teams.

Давайте создадим расширение для сообщений поиска на основе бота, которое может искать реестры npm в 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 для поиска сведений о пакете npm в Teams и Microsoft 365 Copilot. Например, найдите сведения о пакете npm в teamsfx-react в npm-searchlocal.

   

Примечание.

Этот запрос не всегда может 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 для поиска сведений о пакете npm в Teams и Microsoft 365 Copilot. Например, найдите сведения о пакете npm в teamsfx-react в npmsearchlocal.

   

Примечание.

Этот запрос не всегда может 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, выполните следующие действия.

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

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

3. Выберите Подключаемые модули.

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

   

5. В области создания сообщений отправьте сообщение в Microsoft 365 Copilot для поиска сведений о пакете npm в Teams и Microsoft 365 Copilot. Например, найдите сведения о пакете npm в teamsfx-react в npm-searchlocal.

   

Примечание.

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

Портал разработчика 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 см. в разделе Отладка выбора подключаемого модуля.

Включение расширения сообщений в качестве подключаемого модуля для Copilot для собраний

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

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

1. Перейдите на собрание Teams.

2. Выберите Присоединиться.

3. В окне собрания выберите Copilot.

4. Выберите Начать транскрибирование.

   

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

   

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

   

7. Найдите подключаемый модуль и включите переключатель для подключаемого модуля.

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

   

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

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

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

См. также

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