Создание агента расширения сообщений на основе бота для Microsoft 365 Copilot
Примечание.
- Агент расширения сообщений поиска на основе бота доступен в общедоступной предварительной версии для разработчиков.
- В качестве агента в Microsoft 365 Copilot можно расширить только расширение поисковых сообщений на основе бота.
- Агенты для Microsoft 365 Copilot находятся в предварительной версии и работают только в Microsoft 365 Copilot в Microsoft Teams.
Запустите разработку приложений Microsoft Teams с помощью первого приложения Teams. Агент расширения сообщений на основе бота можно создать с помощью JavaScript.
В этом руководстве вы узнаете:
- Настройка нового проекта с помощью набора средств Teams.
- Создание агента расширения сообщений на основе бота.
- Развертывание приложения.
- Активируйте агент расширения сообщений на основе бота в Microsoft 365 Copilot.
Это пошаговое руководство поможет вам создать агент расширения сообщений на основе бота с помощью набора средств Teams. После выполнения этого руководства вы увидите следующие выходные данные:
Предварительные условия
Установите следующие средства для создания и развертывания приложений.
| Установка | Для использования... | |
|---|---|---|
| Required | ||
| Visual Studio Code | JavaScript или TypeScript— среды сборки. Используйте последнюю версию. | |
| Набор средств Teams | Расширение Microsoft Visual Studio Code, которое создает шаблон проекта для вашего приложения. Используйте предварительную версию. | |
| Node.js | Серверной среды выполнения JavaScript. Дополнительные сведения см . вNode.js таблице совместимости версий для типа проекта. | |
| Microsoft Teams | Microsoft Teams позволяет взаимодействовать со всеми пользователями, с которыми вы работаете, с помощью приложений для чата, собраний и звонков в одном месте. | |
| Microsoft Edge (рекомендуется) или Google Chrome | Браузера со средствами разработчика. | |
| Учетная запись разработчика Microsoft 365 | Доступ к учетной записи Teams с соответствующими разрешениями для установки приложения. | |
| Microsoft 365 Copilot | Microsoft 365 Copilot доступна в общедоступной предварительной версии. Убедитесь, что Microsoft 365 Copilot доступны для вашей организации. Вы можете получить среду разработчика для Microsoft 365 Copilot двумя способами: — клиент песочницы Microsoft 365 с Microsoft 365 Copilot (доступен в ограниченной предварительной версии благодаря членству в TAP). — Рабочая среда корпоративного клиента с Microsoft 365 Copilot лицензиями. |
|
| Необязательное | ||
| Средства Azure для Visual Studio Code и Azure CLI | Средства Azure для доступа к хранимым данным или для развертывания облачной серверной части приложения Teams в Azure. | |
| средства разработчика React для Chrome или средства разработчика React для Microsoft Edge | Расширение средств разработки в браузере для библиотеки JavaScript с открытым кодом React. |
Подготовка среды разработки
После установки необходимых средств настройте среду разработки.
Установка набора средств Teams
Примечание.
Поддержка набора средств Teams для расширения сообщений на основе бота доступна только в предварительной версии набора средств Teams. Прежде чем приступить к работе, убедитесь, что вы установили предварительную версию набора средств Teams.
Microsoft Teams Toolkit помогает упростить процесс разработки с помощью средств для подготовки и развертывания облачных ресурсов для приложения и публикации в Магазине Teams.
Набор средств Teams можно использовать с Visual Studio Code. Чтобы установить Набор средств Teams, выполните следующие действия.
Откройте Visual Studio Code и выберите Расширения (CTRL+SHIFT+X️ / ⇧-X или Просмотреть > расширения).
В поле поиска введите Набор средств Teams.
На странице Набор средств Teams щелкните стрелку раскрывающегося списка рядом с элементом Установить.
Выберите Установить предварительную версию.
После установки на панели действий Visual Studio Code появится значок Набора средств
Teams.
Настройка клиента разработки Teams
Клиент — это пространство или контейнер для вашей организации в Teams, где вы общаетесь, обмениваются файлами и выполняете собрания. В этом пространстве также можно отправить и протестировать приложение. Давайте проверим, готовы ли вы к разработке с помощью клиента.
Проверка параметра отправки приложения
После создания приложения необходимо загрузить это приложение в Teams, не распространяя его. Этот процесс называется отправкой приложений. Войдите в учетную запись Microsoft 365, чтобы просмотреть этот параметр.
Примечание.
Убедитесь, что вы включили отправку приложений в предварительную версию и тестирование приложений в локальной среде Teams.
Отправка пользовательских приложений включена через клиент, и администратор должен предоставить доступ для отправки пользовательского приложения. У вас уже есть доступ к клиенту и администратору? Давайте проверка, если вы действительно делаете!
Проверьте, можно ли отправлять приложения в Teams:
В клиенте Teams щелкните значок Приложения .
Выберите Управление приложениями
Выберите Отправить приложение.
Найдите параметр Отправить пользовательское приложение. Если параметр отображается, вы включили отправку пользовательского приложения.
Примечание.
Если вы не найдете параметр для отправки пользовательского приложения, обратитесь к администратору Teams.
Создание бесплатного клиента разработчика Teams (необязательно)
Если у вас нет учетной записи разработчика Teams, ее можно получить бесплатно. Присоединяйтесь к программе для разработчиков Microsoft 365!
Перейдите в программу для разработчиков Microsoft 365.
Выберите Присоединиться и следуйте инструкциям на экране.
На экране приветствия выберите Настроить подписку E5.
Настройте свою учетную запись администратора. После завершения отобразится следующий экран.
Войдите в Teams с помощью только что настроенной учетной записи администратора. Убедитесь, что у вас есть параметр Отправить пользовательское приложение в Teams.
Получение бесплатной учетной записи Azure
Если вы хотите разместить приложение или получить доступ к ресурсам в Azure, у вас должна быть подписка Azure. Перед началом работы создайте бесплатную учетную запись.
Теперь у вас есть все средства для настройки учетной записи. Теперь давайте настроим среду разработки и приступим к сборке! Выберите приложение, которое вы хотите создать.
Создание рабочей области проекта для приложения расширения сообщений
Вы создали приложение бота. Теперь создадим свое первое приложение расширения сообщений.
Возможность расширения сообщений позволяет взаимодействовать с веб-службой. Используйте область создания, командное поле или обмен сообщениями в клиенте Teams для поиска и запуска действий во внешней системе.
Существует два типа расширений сообщений Teams:
- Команды поиска. Вы можете выполнять поиск во внешних системах. Затем можно вставить его результаты в сообщение в виде карта.
- Команды действий. Вы можете предоставить пользователям модальное всплывающее окно для сбора или отображения информации. Затем можно обработать их взаимодействие и отправить информацию обратно в Teams.
Давайте создадим расширение для сообщений с помощью команды поиска. Используйте его для поиска внешних данных и вставки результатов в сообщение в клиенте Teams.
Как вы уже подготовились к созданию этих приложений, вы можете настроить новый проект Teams для создания приложения расширения сообщений.
Примечание.
- Расширения сообщений зависят от ботов для предоставления диалогового окна между пользователем и кодом.
- Только расширение поисковых сообщений на основе бота может быть расширено в качестве агента для Microsoft 365 Copilot.
В этом руководстве вы узнаете:
- Настройка нового проекта расширения сообщений с помощью набора средств Teams.
- Сведения о структуре каталогов проекта приложения.
Создание рабочей области проекта расширения сообщений
Если предварительные требования выполнены, давайте начнем!
Чтобы создать агент расширения сообщений на основе бота, выполните следующие действия.
Откройте Visual Studio Code.
Щелкните значок Набора средств
Teams на панели действий Visual Studio Code.Выберите Создать новое приложение.
Выберите Расширение сообщений , чтобы создать приложение с помощью набора средств Teams.
Выберите Настраиваемые результаты поиска.
Выберите Начать с бота.
Выберите JavaScript в качестве языка.
Выберите Папка по умолчанию , чтобы сохранить корневую папку проекта в расположении по умолчанию.
Вы также можете изменить расположение по умолчанию, выполнив следующие действия.
Нажмите кнопку Обзор.
Выберите расположение рабочей области проекта.
Выберите выбрать папку.
Введите подходящее имя для приложения. Выберите ВВОД.
Teams Toolkit создаст приложение за несколько секунд.
После создания приложения набор средств Teams отображает следующее сообщение:
Для предварительного просмотра проекта можно выбрать Локальная отладка .
Краткий обзор создания приложения Teams.
Просмотрите этот краткий обзор для создания приложения Teams.
Обзор исходного кода приложения расширения сообщений
Расширение сообщений использует Bot Framework. Вы используете его для взаимодействия со службой через беседу. После завершения формирования шаблонов просмотрите каталоги и файлы проектов в области Обозреватель Visual Studio Code.
| Папка и файл | Содержание |
|---|---|
teamsapp.yml |
Основной файл проекта описывает конфигурацию приложения и определяет набор действий, выполняемых на каждом этапе жизненного цикла. |
teamsapp.local.yml |
Это переопределяет teamsapp.yml действия, которые обеспечивают локальное выполнение и отладку. |
.vscode/ |
Файлы VS Code для локальной отладки. |
src/ |
Исходный код для приложения поиска. |
appPackage/ |
Шаблоны для манифеста приложения Teams. |
infra/ |
Шаблоны для подготовки ресурсов Azure. |
src/searchApp.js |
Обрабатывает бизнес-логику для этого шаблона приложения для запроса реестра npm и возврата списка результатов. Дополнительные сведения см. в руководстве по набору средств Teams Visual Studio Code версии 5, чтобы понять, как работает набор средств Teams. |
src/index.js |
index.js используется для настройки и настройки расширения сообщений. Дополнительные сведения см. в руководстве по набору средств Teams Visual Studio Code версии 5, чтобы понять, как работает набор средств Teams. |
Совет
Ознакомьтесь с ботами и расширением сообщений за пределами Teams, прежде чем интегрировать приложение в Teams.
Создание и запуск первого агента расширения сообщений на основе бота
После настройки рабочей области проекта с помощью Набора средств Teams выполните сборку проекта. Необходимо войти в учетную запись Microsoft 365.
Вход в учетную запись Microsoft 365
Используйте эту учетную запись для входа в Teams. Если вы используете клиент программы разработчика Microsoft 365, учетная запись администратора, настроенная при регистрации, — это учетная запись Microsoft 365.
Откройте Visual Studio Code.
Щелкните значок Набора средств
Teams на боковой панели.Выберите Войти в Microsoft 365 с помощью учетных данных.
Откроется веб-браузер по умолчанию, чтобы позволить вам войти в учетную запись.
Закройте браузер при появлении запроса и вернитесь к Visual Studio Code.
Вернитесь к набору средств Teams в Visual Studio Code.
В разделе ACCOUNTS на боковой панели отображается имя учетной записи Microsoft 365. Если для учетной записи Microsoft 365 включена отправка пользовательских приложений, в наборе средств Teams отображается включенная загрузка неопубликованных приложений.
Теперь вы можете создать приложение и запустить его локально!
Создание и запуск приложения в локальной среде
Расширение сообщений позволяет взаимодействовать с веб-службой. Он использует функцию обмена сообщениями и безопасную связь бота. Приложение расширения сообщений добавляется в веб-службу, зарегистрированную в качестве бота.
Локальная сборка и запуск приложения
В левой области выберите Выполнить и отладить (CTRL+SHIFT+D).
Выберите Отладка в Teams (Edge) или Отладка в Teams (Chrome) . Teams Toolkit запускает приложение в Teams с помощью веб-браузера.
Выберите F5 , чтобы создать и запустить приложение локально.
Примечание.
Если набору средств Teams не удается проверка определенных предварительных требований, вам будет предложено проверка.
Узнайте, что происходит при локальном запуске приложения в отладчике.
При выборе F5 набор средств Teams:
- Проверяет все следующие предварительные требования:
- Вы вошли в систему с помощью учетной записи Microsoft 365.
- Для учетной записи Microsoft 365 включена отправка пользовательских приложений.
- Установлена поддерживаемая версия Node.js.
- Порт, необходимый для приложения бота, доступен.
- Установка пакетов npm
- Запускает Dev Tunnel для создания http-туннеля.
- Регистрирует приложение в Microsoft Entra ID и настраивает его.
- Регистрирует приложение бота в Bot Framework и настраивает его.
- Регистрирует приложение на портале разработчика Teams и настраивает его.
- Запускает приложение расширения сообщений, размещенное локально.
- Запускает Teams в веб-браузере и отправляет приложение Teams.
Примечание.
При первом запуске приложения загружаются все зависимости, и приложение создается. По завершении сборки откроется окно браузера. Этот процесс может занять от трех до пяти минут.
Нажмите Добавить. Приложение устанавливается в Teams.
Так как расширения сообщений используют боты для взаимодействия между пользователем и веб-службой, приложение загружается в чат бота.
- Если вы создали приложение-бот перед созданием приложения расширения сообщений, вы увидите, что оно загружено в том же приложении бота, которое вы создали. Предыдущие сообщения чата отображаются.
- Если вы создали расширение для сообщений, приложение загружается в любом чате, открытом в Teams.
Примечание.
Если вы хотите расширить приложение до Outlook и Microsoft 365, вы можете выбрать отладку приложения с помощью Outlook и Microsoft 365 из раскрывающегося списка ЗАПУСК И ОТЛАДКА в Visual Studio Code.
Тестирование приложения
При первой загрузке приложения приложение расширения сообщений открыто для тестирования. Этот пример приложения позволяет выполнять поиск пакетов npm с открытым кодом из реестра программного обеспечения.
Выполнение поискового запроса
Перейдите в чат Teams и выберите Действия и приложения.
Во всплывающем меню расширения сообщений введите имя расширения сообщения в поле поиска.
Выберите расширение сообщений и введите поисковый запрос.
Выберите продукт из списка. Teams разворачивает продукт в адаптивную карточку в сообщении Compose области.
Нажмите кнопку Отправить. Адаптивная карточка отправляется.
Узнайте, как устранять неполадки, если приложение не выполняется локально.
Чтобы запустить приложение в Teams, у вас должна быть учетная запись разработки Microsoft 365, которая позволяет отправлять пользовательские приложения. Дополнительные сведения о отправке пользовательских приложений см. в разделе предварительных требований.
Активация агента расширения сообщений на основе бота в Microsoft 365 Copilot
Чтобы активировать расширение сообщений в Microsoft 365 Copilot, выполните следующие действия.
В левой области выберите Набор средств Teams.
В левой области выберите Выполнить и отладить (CTRL+SHIFT+D).
Выберите Отладка в Copilot (Edge) или Отладка в Copilot (Chrome) .
Выберите F5, чтобы создать и запустить приложение в Microsoft 365 Copilot.
Перейдите в разделПриложенияMicrosoft Teams>.
Найдите Copilot и откройте приложение.
Выберите Панель в правом верхнем углу.
В списке агентов выберите требуемый агент в области справа.
В области создания сообщений отправьте сообщение в Microsoft 365 Copilot, чтобы найти последнее обновление в Teams и Microsoft 365 Copilot.
Примечание.
Этот запрос может не всегда гарантировать ответ от расширения сообщений в Microsoft 365 Copilot. В этом случае попробуйте другие запросы или предоставьте отзыв, понизив Microsoft 365 Copilot ответ и оставив сообщение.
Развертывание первого приложения Teams
Вы научились создавать, создавать и запускать приложение Teams с возможностями расширения сообщений. Последний шаг — развертывание приложения в Azure.
Давайте развернем первое приложение расширения сообщений в Azure с помощью набора средств Teams.
Вход в учетную запись Azure
Используйте эту учетную запись для доступа к портал Azure Майкрософт и подготовки новых облачных ресурсов для поддержки приложения.
Откройте Visual Studio Code.
Откройте папку проекта, в которой вы создали приложение расширения сообщений.
Щелкните значок Набора средств
Teams на боковой панели.Выберите Войти в Azure с помощью учетных данных.
Совет
Если у вас установлено расширение учетной записи AZURE и вы используете ту же учетную запись, этот шаг можно пропустить. Используйте ту же учетную запись, что и в других расширениях.
Откроется веб-браузер по умолчанию, чтобы позволить вам войти в учетную запись.
Закройте браузер при появлении запроса и вернитесь к Visual Studio Code.
В разделе ACCOUNTS боковой панели отображаются две учетные записи по отдельности. В нем также отображается количество доступных для использования подписок Azure. Убедитесь, что у вас есть по крайней мере одна доступная подписка Azure. В противном случае выйдите из нее и используйте другую учетную запись.
Поздравляем! Вы вошли в свою учетную запись Azure! Теперь давайте рассмотрим, как развернуть одно из приложений в Azure с помощью набора средств Teams.
Развертывание приложения в Azure
Развертывание состоит из двух этапов. Во-первых, создаются необходимые облачные ресурсы (также известные как подготовка). Затем код приложения копируется в созданные облачные ресурсы. В этом руководстве вы развернете приложение расширения сообщений.
В чем разница между подготовкой и развертыванием?
Шаг подготовки создает ресурсы в Azure и Microsoft 365 для приложения, но код (HTML, CSS, JavaScript и т. д.) не копируется в ресурсы. Шаг Развертывание копирует код приложения в ресурсы, созданные на этапе подготовки. Обычно развертывание выполняется несколько раз без подготовки новых ресурсов. Так как процесс подготовки может занять некоторое время, он отделен от шага развертывания.
Выберите значок Набор инструментов Teams на боковой панели Visual Studio Code.
Выберите Подготовка.
Выберите подписку, используемую для ресурсов Azure.
Приложение размещается с помощью ресурсов Azure. В диалоговом окне появится предупреждение о том, что при выполнении ресурсов в Azure могут возникнуть затраты.
Выберите Подготовка.
Процесс подготовки создает ресурсы в облаке Azure. Это может занять некоторое время. Ход выполнения можно отслеживать, наблюдая за диалогами в правом нижнем углу. Через несколько минут вы увидите следующее уведомление:
При необходимости можно просмотреть подготовленные ресурсы. В этом руководстве вам не нужно просматривать ресурсы.
Подготовленный ресурс отображается в разделе СРЕДА .
После завершения подготовки выберите Развернуть на панели ЖИЗНЕННЫЙ цикл .
Как и при подготовке, развертывание занимает некоторое время. Вы можете отслеживать процесс, наблюдая за диалогами в правом нижнем углу. Через несколько минут вы увидите уведомление о завершении.
Теперь вы можете использовать тот же процесс для развертывания приложений Bot и расширения сообщений в Azure.
Запуск развернутого приложения
После завершения действий по подготовке и развертыванию:
Откройте панель отладки (CTRL+SHIFT+D️ / ⇧-D или Просмотр > запуска) из Visual Studio Code.
В раскрывающемся списке конфигурация запуска выберите Запустить удаленное управление (edge).
Нажмите кнопку Начать отладку (F5), чтобы запустить приложение из Azure.
Нажмите Добавить.
Узнайте, что происходит при развертывании приложения в Azure
До развертывания приложение работает локально:
- Серверная часть работает с использованием Azure Functions Core Tools.
- Конечная точка HTTP приложения, в которую Microsoft Teams загружает приложение, работает локально.
Развертывание — это двухэтапный процесс. Вы подготавливаете ресурсы в активной подписке Azure, а затем развертываете или отправляете код серверной части и внешнего интерфейса для приложения в Azure.
- Если серверная часть настроена, использует различные службы Azure, включая Служба приложений Azure и службу хранилища Azure.
- Интерфейсное приложение развертывается в учетной записи хранения Azure, настроенной для статического веб-размещения.
Поздравляем!
Вы создали расширение сообщений на основе бота и расширили его в качестве агента в Microsoft 365 Copilot.
Возникла проблема с этим разделом? Если это так, отправьте нам отзыв, чтобы мы исправили этот раздел.
Platform Docs