エージェントとアプリ開発者向けの Teams プレビュー機能

Microsoft は多くの場合、新しい Teams プラットフォーム機能を一般公開する前に開発者が利用できるようにします。 これらのプレビュー機能をエージェントとアプリのテスト バージョンに統合し、フィードバック を提供し 、リリース後すぐに使用できるように準備することを検討してください。

プレビュー関連の実装とユーザー エクスペリエンスに関する考慮事項は機能によって異なりますが、各プレビュー機能のドキュメントで説明しています。 この記事では、最も一般的な 2 つの要件について説明します。

• 機能の評価とテストのための Teams パブリック プレビューへの参加
• 開発者プレビュー アプリ マニフェストの使用

プレビュー機能の開発者およびユーザー向けの両方の側面は、リリース前に変更される可能性があります。 プレビュー機能の統合をコントロールされた対象ユーザーとテストします。 実稼働環境にリリースされたエージェントまたはアプリにプレビュー機能を統合しないでください。

Teams パブリック プレビュー

Teams パブリック プレビューは、Teams クライアントのオプトイン機能であり、ユーザーが未リリースの Teams 機能を選んだセットを体験できるようにします。 パブリック プレビュー機能は一般に開発者が無条件に使用できますが、ユーザーが Teams クライアントでアクセスするにはパブリック プレビューに参加する必要があります。

パブリック プレビューへのユーザーの参加は、管理者ポリシーによって制御されます。 管理者は、参加を必須または禁止するポリシーを設定したり、ユーザーがオプトインするかどうかを個別に決定できるようにしたりできます。 パブリック プレビュー機能をエージェントとアプリに統合する開発者は、パブリック プレビューを有効にして独自の評価とテストを実行する必要があります。また、管理者と協力してテストに関係するユーザーを登録する必要があります。 パブリック プレビューを有効にする方法の詳細については、Teams 管理者向けドキュメントの Microsoft Teams パブリック プレビュー を参照してください。

ユーザーのパブリック プレビューへの参加状態は、開発者、エージェント、またはアプリには通知されず、一般的な機能フラグとして使用することはできません。 開発者がエージェントやアプリに統合する可能性のあるプラットフォーム機能へのアクセスのみが決定されます。

どの Teams ユーザーも、管理者ポリシーに従ってパブリック プレビューにオプトインできますが、運用ユーザーによる参加を期待または要求する必要はありません。

開発者向けプレビューのアプリ マニフェスト

多くの場合、アプリ マニフェストの構成に依存するプレビュー機能には、 アプリ マニフェストの開発者プレビュー バージョンが必要です。 これを使用するには、アプリ マニフェストで次の $schema 値と manifestVersion 値を指定します。

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

開発者プレビュー版のマニフェストを使用するエージェントとアプリには、次の制限があります。

• Teams ストアに公開することはできません。
• 直接 アップロードを介して Teams クライアントにのみインストールできます。
• Teams 開発者ポータルでは管理できません。 開発者プレビュー版のマニフェストを含むアプリ パッケージは、手動でアセンブルする必要があります。 開発者ポータルを使用して、エージェントまたはアプリの構成の大部分を作成した後、パッケージをエクスポートして最終的な変更を手動で行うことを検討してください。

アプリ マニフェストの開発者プレビュー バージョンの詳細については、 専用のドキュメントを参照してください。