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

Примечание.

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

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

Дополнительные сведения о расширении Copilot для Microsoft 365 с помощью расширений сообщений Teams см. в этом видео:

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

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

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

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

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

Дополнительные сведения см. в разделе Определение описаний.

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

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

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

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

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

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

Важно!

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

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

Активация расширения сообщений в чате M365

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

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

2. Поиск для чата M365 и откройте приложение M365 Chat.

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

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

   

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

   

Примечание.

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

Visual Studio

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

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

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

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

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

3. Поиск для Teams и выберите Приложение Microsoft Teams.

4. Выберите Результаты пользовательских Поиск.

   

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

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

   
   

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

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

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

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

   

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

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

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

    

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

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

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

    

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

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

    

Активация расширения сообщений в чате M365

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

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

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

   

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

4. Поиск для чата M365 и откройте приложение M365 Chat.

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

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

   

7. В области создания сообщений отправьте сообщение в чат M365, чтобы найти сведения о пакете npm в Teams и Copilot. Например, найдите сведения о пакете npm в teamsfx-react в npmsearchlocal.

   

Примечание.

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

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

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

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

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

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

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

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

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

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

7. Нажмите ОК.

   

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

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

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

   npm install -g @microsoft/teamsfx-cli@beta
   

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

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

   

5. Выберите Результаты пользовательских Поиск.

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

   

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

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

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

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

    teamsfx provision --env dev
   

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

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

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

    

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

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

    

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

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

     teamsfx preview --env dev
    

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

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

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

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

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

Активация расширения сообщений в чате M365

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

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

2. Поиск для чата M365 и откройте приложение M365 Chat.

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

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

   

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

   

Примечание.

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

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

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

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

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

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

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

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

   

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

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

   

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

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

   

8. Нажмите кнопку Сохранить.

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

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

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

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

11. Нажмите кнопку Сохранить. Команда добавляется в расширение сообщения.

12. Нажмите кнопку Сохранить.

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

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

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

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

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

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

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

См. также

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