Управление приложениями Microsoft Teams на Портале разработчика

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

Обзор

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

• Панель мониторинга

  • На панели мониторинга в разделе Обзор можно просмотреть следующие компоненты приложения:

    • Рекомендация. Средство проверки приложений проверяет пакет приложения на соответствие тестовых случаев, которые корпорация Майкрософт использует при проверке приложения.
    • Объявление: отображает последние обновления приложений на портале разработчика.
    • Активные пользователи (предварительная версия): отображает число активных пользователей.
    • Основные сведения. Отображает идентификатор приложения, версию, версию манифеста и другие основные сведения.

    

• Аналитика.

  В разделе "Аналитика " в разделе "Обзор " вы можете получить общие сведения об использовании приложения, вовлеченности и других аналитических сведениях. Дополнительные сведения см. в статье Анализ использования приложения.

Configure (Настроить)

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

В разделе Настройка можно просмотреть следующие компоненты для управления приложением и доступа к ней:

• Основные сведения. В этом разделе отображаются и позволяют изменять имена приложений, идентификатор приложения, описания, версию, сведения о разработчике, URL-адреса приложения, идентификатор приложения (клиента) и идентификатор сети партнеров Майкрософт (идентификатор CCP).

• Фирменная символика. В этом разделе можно добавить значок цвета и значок контура в .png формате.

• Функции приложения. В этом разделе можно добавить в приложение следующие функции:

  • Личное приложение
  • Bot
  • Connector
  • Сцены
  • Приложение для групп и каналов
  • Расширение для обмена сообщениями
  • Расширение для собрания
  • Уведомление веб-канала действий

  Примечание.

  Соединитель доступен в облаке сообщества для государственных организаций (GCC), но недоступен в GCC High, Министерстве обороны (DoD) и Teams, управляемых средами 21Vianet.

• Редактор пакетов приложений. Этот раздел позволяет создавать, администрировать и настраивать пакеты приложений для Teams. Как и Visual Studio Code, он позволяет легко редактировать компоненты приложения, включая манифест, значки, файлы агента Copilot, сцены, JSON и файлы YAML. Вы также можете добавить декларативный агент и связанные с ним файлы в пакет приложения.

  

  После изменения или добавления новых файлов в пакет приложения можно отменить или обновить пакет. Если нажать кнопку Обновить, портал разработчика проверяет файлы и выявляет ошибки. Вы можете сохранить пакет с ошибками, но их необходимо устранить перед публикацией.

  

  Примечание.

  Если версия манифеста приложения — 1.19, можно добавить декларативный агент с помощью этого редактора пакетов приложений. Чтобы создать декларативный агент, добавьте JSON-файл, определяющий поведение агента. Вы также можете создать файл YAML для определения пользовательских API и подключения их к декларативному агенту.

  
  
  Добавление декларативного агента в пакет приложения с помощью портала разработчика

  
  

  Перед добавлением декларативного агента в пакет приложения убедитесь, что пакет приложения обновлен до последней версии 1.19.

  1. На портале разработчика Teams выберите Приложения в области слева и выберите свое приложение.

  2. Перейдите в раздел Настройка>редактора пакетов приложений.

     

  3. Выберите многоточие (...) в разделе Действияфайла manifest.json и выберите Изменить.

     

  4. Добавьте свойство copilotAgents манифеста и вложенное свойство declarativeAgentsи определите необходимые сведения. Выберите Сохранить.

     

  5. Выберите Новый файл JSON и> определите поведение агента.

     

  6. Нажмите кнопку Обновить.

     

     Теперь портал разработчика проверяет файлы и выявляет ошибки, которые необходимо устранить перед публикацией.

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

  Примечание.

  Максимальное ограничение для разрешений RSC — 16.

• Единый вход. Бот, зарегистрированный в Microsoft Entra ID, поддерживает единый вход. Если бот зарегистрирован на портале Bot Framework (или на портале разработчика в разделе Управление ботами), то бот не поддерживает единый вход, и для поддержки единого входа необходимо зарегистрировать бот на Microsoft Entra ID. Для бота, зарегистрированного в Microsoft Entra ID, добавьте URI идентификатора приложения. Чтобы получить URI идентификатора приложения из Microsoft Entra ID, см. сведения об использовании проверки подлинности единого входа для ботов.

• Языки. В этом разделе можно настроить или изменить язык приложения.

• Домен. В этом разделе можно добавить домены для загрузки приложений в клиенте Teams, например *.example.com.

Дополнительно

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

• Владельцы

  Каждое приложение содержит страницу "Владельцы" , где вы можете поделиться своей регистрацией с другими пользователями в вашей организации. Вы можете добавить роли администратора и оперативного администратора, чтобы управлять тем, кто может изменять параметры вашего приложения. У роли "Оперативная " есть разрешение, например обновление конфигурации приложения. Роль администратор имеет разрешения, такие как обновление конфигурации приложения, добавление или удаление владельцев, а также удаление приложения. Если для приложения нет активных владельцев, администраторы могут владеть приложениями, введя идентификатор приложения на портале разработчика Teams.

  Ниже представлен порядок добавления владельца.

  1. В разделе Дополнительно выберите Владельцы.
  2. Выберите Добавить владельцев.
  3. Введите имя и выберите идентификатор пользователя в раскрывающемся списке.
  4. В разделе Роль выберите Оперативный или Администратор.
  5. Нажмите Добавить.

• Содержимое приложения. Вы можете настроить приложение со следующими функциями:

  • Индикатор загрузки. Отображает индикатор, чтобы сообщить пользователям, что содержимое размещенного приложения (например, вкладки и диалоги (называемые модулями задач в TeamsJS версии 1.x)) загружается.
  • Полноэкранный режим: отображает личное приложение без заголовка приложения. Он поддерживается для опубликованных приложений в вашей организации.
  • Поддерживаемые типы каналов. Список нестандартных типов каналов, поддерживаемых приложением.
  • Возможность группы по умолчанию. Для приложений, поддерживающих несколько возможностей группы, таких как команды, групповой чат или собрания, выберите возможность навигации по умолчанию при добавлении приложения из Microsoft Teams Store.

• Средах

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

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

  1. На портале разработчика выберите приложения , которые вы работаете.
  2. Перейдите в раздел "Среды " в разделе Дополнительно .
  3. Выберите + Добавить среду>Добавить.

  • Глобальные переменные

    1. Выберите Добавить глобальную переменную , чтобы создать переменные конфигурации для среды.

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

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

1. Введите {{ любое поле на портале разработчика. Откроется раскрывающийся список, в котором отображаются все переменные, созданные для выбранной среды, а также глобальные переменные.
2. Перед загрузкой пакета приложения (например, при подготовке к публикации в Магазине Teams) выберите среду, которую вы хотите использовать. Конфигурации приложений автоматически обновляются в зависимости от среды.

• Планирование и цены. Связывание предложения SaaS (программное обеспечение как услуга), созданного в Центре партнеров для приложения.
• параметры Администратор:
  • Настройка приложения. Настройте приложение, выбрав различные свойства, такие как Имя, Краткое описание, Маленький значок и другие свойства.
  • Блокировать приложение по умолчанию. Блокировать приложение по умолчанию для пользователей, пока администратор Teams не включит его.

Разработка

В разделе Разработка откройте и разработайте приложение с помощью microsoft 365 Agents Toolkit (ранее известного как Набор средств Teams) в Visual Studio Code и Visual Studio. Дополнительные сведения см. в статье Разработка приложения с помощью microsoft 365 Agents Toolkit.

Публикация

В разделе Публикация опубликуйте приложение в организации или в Магазине Teams.

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

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

  

  Если ваше приложение не удается выполнить какой-либо тестовый случай, ознакомьтесь с рекомендациями и внесите необходимые обновления в пакет приложения на основе результатов тестового случая Майкрософт. Вы также можете скачать пакет приложения и отчет о проверке. Дополнительные сведения о тестовых случаях Майкрософт см . в разделах Рекомендации по проверке Магазина Teams и Политики сертификации коммерческой платформы.

  
  
  Проверка пакета приложения

  
  

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

  1. На портале разработчика Teams выберите Приложения в области слева и выберите свое приложение.

  2. Перейдите в раздел Публикация>проверки> приложенияНачало работы.

     

  3. Установите все флажки в разделе Подтверждение проверки и нажмите кнопку Начать проверку.

     

     Примечание.

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

     Портал разработчика Teams теперь начинает проверять пакет приложения:

     

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

     1. Создано: после нажатия кнопки Начать проверку.
     2. Выполняется: инициируется проверка приложения.
     3. Завершено: проверка приложения завершена.

     Выберите Обновить состояние , чтобы получить последнее состояние проверки, когда проверка выполняется.

     

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

     Состояние	Проверка	Результат	Описание
     Success	Завершение	Пройти	Нет проблем.
     Warning	Завершение	Пройти	Исправление этой проблемы является необязательным, но рекомендуется.
     Ошибка	Завершение	Не	Чтобы успешно опубликовать приложение, необходимо устранить эту проблему.
     Пропущено	Неполной	Н/Д	Мы не смогли продолжить проверку проверка. Это может быть временной проблемой. Мы рекомендуем повторно запустить тест позже.

     

  Примечание.

  • Проверка приложений поддерживается только для приложений с поддержкой бота.
  • Средство проверки приложений оценивает пакет приложения на основе тестовых случаев, которые корпорация Майкрософт использует для проверки приложений перед отправкой в Microsoft Teams Store. Устраните ошибки или предупреждения и прочтите контрольный список отправки приложений перед отправкой приложения.

• Публикация в организации:

  1. На портале разработчика выберите Приложения , над которыми вы работаете.
  2. Перейдите к разделу Опубликовать в организации в разделе Опубликовать.
  3. Выберите Опубликовать приложение.

• Публикация в Store:

  1. На портале разработчика выберите Приложения , над которыми вы работаете.
  2. Перейдите к разделу Опубликовать в Store в разделе Опубликовать.
  3. Нажмите Опубликовать.

  Скачайте пакет приложения, нажав кнопку Скачать пакет приложения на странице Публикация в хранилище .

Тестирование приложения непосредственно в Teams

Портал разработчика предоставляет варианты тестирования и отладки приложения:

• На странице Обзор просмотрите snapshot, настроено ли ваше приложение и проверено на тестовые случаи в Магазине Teams.
• Кнопка Предварительный просмотр в Teams позволяет быстро запустить приложение в клиенте Teams для отладки.

Использование средств для создания функций приложения

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

• Студия сцен. Разработка настраиваемых сцен в режиме "Вместе" в собраниях Teams для Teams.
• Редактор адаптивных карточек (предварительная версия): создайте и просмотрите адаптивные карточки для включения в приложения.
• Управление платформой удостоверений (предварительная версия): зарегистрируйте приложения с помощью Microsoft Entra ID, чтобы помочь пользователям входить в систему и предоставить доступ к API.
• Проверка приложений из Магазина Teams. Проверьте пакет приложения на наличие тестовых случаев, которые корпорация Майкрософт использует для проверки вашего приложения. Мы рекомендуем использовать последнюю версию средства проверки приложения в приложении в разделе Публикация .
• Схема удостоверений агента. Создание, настройка и управление многократно используемыми схемами, которые определяют Agent 365 и сведения о его внутреннем подключении. Дополнительные сведения см. в разделе Схема удостоверений агента.
• Управление ботами. Добавьте в приложение диалоговых ботов, которые взаимодействуют с пользователями, отвечают на их вопросы и заблаговременно уведомляют их об изменениях и других событиях.

Добавление бота:

1. На портале разработчика выберите Сервис в области слева.

2. Выберите Управление ботами.

   

3. На странице Управление ботом выберите + Создать бота.

4. Введите имя и нажмите кнопку Добавить.

   

На портале разработчика перейдите на портал Bot Framework и настройте бота для обновления значка и других свойств.

Схема удостоверений агента

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

Создание схем удостоверений агента и управление ими на портале разработчика, а управление удостоверениями агентов, производными от них, в Microsoft 365 Admin Center. Чтобы получить исчерпывающие рекомендации по расширению агента до Agent 365, используйте пакет SDK для Microsoft Agent 365.

Просмотр и использование существующих схем удостоверений агента

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

Используйте схему удостоверений агента, чтобы:

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

Если подходящая схема не существует, создайте новую.

Создание схемы удостоверений агента

1. На портале разработчика Teams перейдите в раздел Сервис и выберите Схема удостоверений агента.

   

2. Выберите + Создать схему.

   

3. Введите имя и нажмите кнопку Создать.

   

   Уникальный идентификатор схемы агента создается автоматически. Используйте этот идентификатор при создании удостоверений агента на основе этой схемы.

Настройка схемы удостоверений агента

Каждая схема включает в себя две ключевые области конфигурации:

1. Основные сведения. Просмотрите следующую базовую конфигурацию схемы:

   • Идентификатор схемы агента. Созданный системой уникальный идентификатор схемы.
   • Имя: имя, присвоенное при создании схемы.

   

2. Конфигурация. На этой вкладке укажите, как агент взаимодействует со своей службой.

   • На вкладке Конфигурация перейдите в раздел Тип агента.

     • Выберите способ подключения агента к внутренней службе.

     • Выберите один из приведенных ниже вариантов.

       Тип агента	Описание
       none	Нет связи с ботом или API (по умолчанию).
       На основе бота	Используйте существующего бота, зарегистрированного в Teams.
       На основе API	Используйте пользовательскую конечную точку API для определения поведения агента.

   • В зависимости от выбранного типа агента введите одно из следующих значений:

     • Идентификатор бота. Если выбран параметр На основе ботов, укажите идентификатор зарегистрированного бота Teams.
     • URL-адрес серверной части. Если вы выбрали на основе API, укажите URL-адрес конечной точки серверной службы.

   • Нажмите кнопку Сохранить , чтобы применить конфигурацию.

   • Нажмите кнопку Вернуть , чтобы отменить изменения.

   

См. также

• Центр администрирования Teams
• Обзор набора средств агентов Microsoft 365
• Включение предложения SaaS в приложение Microsoft Teams
• Инструкции магазина Teams по проверке приложений
• Политики сертификации коммерческой платформы