Поделиться через


Создание нового приложения Teams

В этом разделе описано, как создать проект Microsoft Teams с помощью Microsoft Visual Studio Code.

Создание проекта Teams с помощью Visual Studio Code

Вы можете создать новый проект Teams, выбрав Создать агент или приложение в наборе средств агентов Microsoft 365 (ранее — Набор средств Teams). Вы можете начать со встроенных шаблонов приложений Teams или с официальных примеров приложений Teams в наборе средств агентов. Более того, набор средств агентов поддерживает создание собственных надстроек Outlook с помощью шаблонов надстроек Outlook.

Снимок экрана: параметры возможности приложения.

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

Типы приложений Определение
Приложения Teams на основе сценариев Эта группа шаблонов предназначена для конкретных абстрактных бизнес-сценариев, для которых может служить приложение teams. Например, бот уведомлений, командный бот, вкладка с поддержкой единого входа или приложение вкладки панели мониторинга.
Базовые приложения Teams Базовые приложения Teams — это просто вкладка Hello world Teams, бот или расширение для сообщений, которые можно создать и настроить в соответствии с вашими требованиями.
Расширение приложения Teams в Microsoft 365 Эту группу приложений Teams можно установить и запустить в Outlook и Office.com.

Создание нового приложения Teams

Процесс создания нового приложения Teams аналогичен для всех типов приложений.

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

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

  2. Выберите Microsoft 365 Agents Toolkit>Создать новый агент или приложение> , выберите Агенты и приложения Teams.

    Снимок экрана: кнопка

  3. Выбор других возможностей Teams

    Снимок экрана: выбор других возможностей Teams.

  4. В этом примере выберите Tab в качестве возможности приложения.

    Снимок экрана: выбранная возможность приложения.

  5. Выберите Папка по умолчанию , чтобы сохранить корневую папку проекта в расположении по умолчанию.

    Снимок экрана: выбор выбранного параметра расположения по умолчанию.

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

    1. Нажмите кнопку Обзор.

      Снимок экрана: выделенный параметр

    2. Выберите расположение рабочей области проекта.

      Снимок экрана: выделенный параметр

    Выбранная папка — это расположение рабочей области проекта.

  6. Введите подходящее имя приложения, например helloworld, в качестве имени приложения. Убедитесь, что используются только буквенно-цифровые символы. Нажмите клавишу ВВОД.

    Снимок экрана: где ввести имя приложения.

    Приложение-вкладка Teams будет создано через несколько секунд.

    Снимок экрана: созданное приложение.

Структура каталогов для различных типов приложений

Набор средств агентов предоставляет все компоненты для создания приложения. После создания проекта можно просмотреть папки и файлы проекта в разделе EXPLORER .


Структура каталогов для базового приложения Teams

В следующем примере показана базовая структура каталогов приложения вкладки Teams:

Имя папки Содержание
.vscode Параметры для VS Code для создания и отладки приложения Teams.
appPackage Файлы манифеста приложения (ранее называемые манифестом приложения Teams) и файлы значков, которые Teams использовали для распознавания приложения Teams.
env Хранит различные параметры среды.
infra bicep Azure файлы шаблонов. Используется для развертывания приложения Teams в Azure.
src Исходный код для возможности tab, включая интерфейсное приложение, компоненты пользовательского интерфейса и уведомление о конфиденциальности, условия использования,
src/app.js Точка входа приложения и express обработчики для веб-сайта.
src/views/hello.html Шаблон HTML, который привязывается к конечной точке вкладки.
src/static Веб-сервер может обслуживать статические ресурсы, такие как файлы CSS и JavaScript.
m365agents.yml Этот файл конфигурации определяет поведение набора средств агентов для жизненного цикла подготовки, развертывания и публикации. Этот файл можно настроить, чтобы изменить поведение набора средств агентов в каждом жизненном цикле.
m365agents.local.yml Это переопределяет m365agents.yml действиями, которые обеспечивают локальное выполнение и отладку.

Примечание.

Если у вас есть бот или приложение расширения сообщений, в структуру каталогов добавляются соответствующие папки.

Дополнительные сведения о структуре каталогов различных типов базовых приложений Teams см. в следующей таблице:

Тип приложения Ссылки
Для приложения вкладки Создание первого приложения вкладки с помощью JavaScript
Для приложения бота Создание первого приложения бота с помощью JavaScript
Для приложения расширения сообщений Создание первого приложения расширения для сообщений с помощью JavaScript

Структура каталогов для приложения Teams на основе сценария

В следующем примере показана структура каталога приложения Teams бота уведомлений на основе сценария.

Папка нового проекта содержит следующее содержимое:

Имя папки Содержание
.vscode Параметры для VS Code для создания и отладки приложения Teams.
appPackage Файл манифеста приложения и файлы значков, которые Teams использовали для распознавания приложения Teams.
env Хранит различные параметры среды.
infra bicep Azure файлы шаблонов. Используется для развертывания приложения Teams в Azure.
m365agents.yml Этот файл конфигурации определяет поведение набора средств агентов для жизненного цикла подготовки, развертывания и публикации. Этот файл можно настроить, чтобы изменить поведение набора средств агентов в каждом жизненном цикле.
m365agents.local.yml Это переопределяет m365agents.yml действиями, которые обеспечивают локальное выполнение и отладку.

Базовая реализация уведомления хранится в папке src и содержит:

Имя файла Содержание
src\adaptiveCards\ Шаблоны для адаптивной карточки.
src\internal\ Созданный код инициализации для функций уведомлений.
src\index.ts Точка входа для обработки сообщений бота и отправки уведомлений.
.gitignore Файл для исключения локальных файлов из проекта бота.
package.json Файл пакета npm для проекта бота.

Примечание.

Если у вас есть бот команд, бот рабочего процесса, вкладка с поддержкой единого входа или приложение-вкладка SPFx, в структуру каталогов добавляются соответствующие папки.

Дополнительные сведения о структуре каталогов различных типов приложений Teams на основе сценариев см. в следующей таблице:

Тип приложения Ссылки
Для приложения бота уведомлений Отправка уведомления в Teams
Для приложения бота команд Бот командной сборки
Для приложения бота рабочего процесса Создание бота рабочего процесса Teams
Для приложения вкладки SPFx Создание приложения Teams с помощью SPFx

Дополнительные пошаговые инструкции по созданию приложений см. в руководстве.

См. также