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

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

• Установите последнюю предварительную версию набора средств 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. Нажмите кнопку Отправить.

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

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

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

2. Найдите Copilot и откройте приложение Copilot для Microsoft 365 .

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

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

   

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

   

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

• Установите 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. Нажмите кнопку Отправить. Адаптивная карточка отправляется в чат.

    

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

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

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

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

   

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

4. Найдите Copilot для Microsoft 365 и откройте приложение Copilot для Microsoft 365 .

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

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

   

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

   

Прежде чем приступить к работе, убедитесь, что для переменной среды 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/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. Выберите расширение сообщений и введите поисковый запрос.

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

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

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

2. Найдите Copilot для Microsoft 365 и откройте приложение Copilot для Microsoft 365 .

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

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

   

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

   

Чтобы создать расширение сообщений на основе бота с помощью портала разработчика для 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. Вы можете отправить пакет приложения в команды и протестировать расширение сообщений.