Предварительные версии функций Teams для разработчиков агентов и приложений

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

Рекомендации, связанные с реализацией и взаимодействием с предварительной версией, зависят от функции, и они объясняются в документации по каждой функции предварительной версии. В этой статье описаны два наиболее распространенных требования:

• Участие в общедоступной предварительной версии Teams для оценки и тестирования функций
• Использование манифеста приложения для предварительного просмотра разработчика

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

Общедоступная предварительная версия Teams

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

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

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

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

Манифест предварительной версии приложения для разработчиков

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

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json",
  "manifestVersion": "devPreview"
}

Агенты и приложения, использующие версию манифеста разработчика Preview, имеют следующие ограничения:

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

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