開発者ポータルでアプリを管理する

Microsoft Teams にアプリをアップロードしたら、開発者ポータルでアプリを管理できます。 この記事では、Teams アプリのエクスペリエンスを向上させるためのアプリの構成、分析、検証に関する包括的なガイダンスを提供します。 さらに、エージェントのエージェント ID を作成および管理するためのエージェント ID ブループリントについても学習します。

概要

概要セクションでは、アプリを管理するための次のコンポーネントを確認できます。

• ダッシュボード

  • [概要] セクションのダッシュボードで、アプリの次のコンポーネントを表示できます。

    • 推奨事項: アプリ検証ツールは、Microsoft がアプリをレビューするときに使用するテスト ケースに対してアプリ パッケージをチェックします。
    • お知らせ: 開発者ポータルにアプリの最新の更新を表示します。
    • アクティブ ユーザー (プレビュー): アクティブなユーザー数が表示されます。
    • 基本情報: アプリ ID、 バージョン、 マニフェストのバージョン、およびその他の基本情報を表示します。

    

• 分析

  [概要] セクションの [分析] では、アプリの使用状況、エンゲージメント、その他の分析情報の概要を取得できます。 詳細については、「 アプリの使用状況を分析する方法」を参照してください。

Configure

Teams にアプリをインストールしてレンダリングするには、Teams が認識できる一連の構成を含める必要があります。 Teams でアプリをアップロードするには、Teams でアプリを表示するためのすべてのアプリの詳細を含むアプリ マニフェストが必要です。 これは、開発者ポータルで利用可能なコンポーネントとツールの助けを借りて実現できます。

[ 構成] セクションでは、アプリを管理してアクセスするための次のコンポーネントを確認できます。

• 基本情報: このセクションには、 アプリ名、 アプリ ID、 説明、 バージョン、 開発者情報、 アプリ URL、 アプリケーション (クライアント) ID、 Microsoft パートナー ネットワーク ID (CCP ID) が表示され、編集できます。

• ブランド化: このセクションでは、.png形式で [色] アイコンと [アウトライン] アイコンを追加できます。

• アプリの機能: このセクションでは、次の機能をアプリに追加できます:

  • 個人用アプリ
  • Bot
  • Connector
  • シーン
  • グループとチャネル アプリ
  • メッセージング拡張機能
  • 会議の拡張機能
  • アクティビティ フィードの通知

  注:

  コネクタは Government Community Cloud (GCC) では使用できますが、GCC High、国防総省 (DoD)、21Vianet 環境で運用されている Teams では使用できません。

• アプリ パッケージ エディター: このセクションでは、Teams 用のアプリ パッケージを作成、管理、カスタマイズできます。 Visual Studio Code と同様に、マニフェスト、アイコン、Copilot エージェント ファイル、シーン、JSON、YAML ファイルなどのアプリのコンポーネントをシームレスに編集できます。 宣言型エージェントとその関連ファイルをアプリ パッケージに追加することもできます。

  

  アプリ パッケージを編集または新しいファイルを追加した後、パッケージを破棄または更新できます。 [ 更新] を選択すると、開発者ポータルはファイルを確認し、エラーを識別します。 エラーのあるパッケージを保存することはできますが、エラーを解決してから公開する必要があります。

  

  注:

  アプリ マニフェストのバージョンが v1.19 の場合は、このアプリ パッケージ エディターを使用して宣言型エージェントを追加できます。 宣言型エージェントを作成するには、エージェントの動作を定義する JSON ファイルを追加します。 YAML ファイルを作成してカスタム API を定義し、宣言型エージェントに接続することもできます。

  
  
  開発者ポータルを使用してアプリ パッケージに宣言型エージェントを追加する

  
  

  宣言型エージェントをアプリ パッケージに追加する前に、アプリ パッケージが最新バージョン v1.19 に更新されていることを確認してください。

  1. Teams 開発者ポータルで、左側のウィンドウから [ アプリ ] を選択し、アプリを選択します。

  2. Configure>App パッケージ エディターに移動します。

     

  3. manifest.json ファイルの [アクション] の下にある省略記号 (...) を選択し、[編集] を選択します。

     

  4. マニフェスト プロパティ copilotAgents とサブプロパティ declarativeAgentsを追加し、必要な詳細を定義します。 [保存] を選択します。

     

  5. [新しいファイル>JSON ファイル] を選択し、エージェントの動作を定義します。

     

  6. [更新] を選択します。

     

     これで、デベロッパー ポータルがファイルを確認し、エラーを識別します。これは公開する前に解決する必要があります。

• アクセス許可: このセクションでは、アプリのデバイス アクセス許可、チーム アクセス許可、Chat/Meeting アクセス許可、およびユーザー アクセス許可を付与できます。

  注:

  RSC アクセス許可の上限は 16 です。

• シングル サインオン: Microsoft Entra ID に登録されているボットは、シングル サインオン (SSO) をサポートします。 ボットが Bot Framework ポータル (またはボット管理の下の開発者ポータル内) に登録されている場合、ボットは SSO をサポートしていないため、SSO をサポートするにはボットを Microsoft Entra ID に登録する必要があります。 Microsoft Entra ID に登録されているボットの場合は、アプリケーション ID URI を追加します。 Microsoft Entra ID からアプリケーション ID URI を取得するには、「ボットに SSO 認証を使用する方法」を参照してください。

• 言語: このセクションでは、アプリの言語を設定または変更できます。

• ドメイン: このセクションでは、*.example.com などのドメインを追加して、Teams クライアントにアプリを読み込むことができます。

詳細設定

[詳細] セクションでは、開発者ポータルでアプリを管理するための次のコンポーネントを表示できます。

• 所有者

  各アプリには [所有者] ページが含まれており、アプリの登録を組織内の他のユーザーと共有できます。 管理者 ロールと 操作ロール を追加して、アプリの設定を変更できるユーザーを管理できます。 オペレーター ロールには、アプリの構成の更新などのアクセス許可があります。 管理者ロールには、アプリの構成の更新、所有者の追加または削除、アプリの削除などのアクセス許可があります。 アプリのアクティブな所有者がいない場合、管理者は Teams 開発者ポータルにアプリ ID を入力することでアプリを所有できます。

  所有者を追加するには:

  1. [ 詳細設定 ] セクションで、[ 所有者] を選択します。
  2. [ 所有者の追加] を選択します。
  3. 名前を入力し、ドロップダウン リストからユーザー ID を選択します。
  4. [ 役割] で、[ 運用] または [管理者] を選択します。
  5. [追加] を選択します。

• アプリ コンテンツ: 次の機能を使用してアプリを構成できます。

  • 読み込み中インジケーター: ホストされているアプリのコンテンツ (タブやダイアログ (TeamsJS v1.x ではタスク モジュールと呼ばれます) など) が読み込まれていることをユーザーに知らせるインジケーターを表示します。
  • 全画面表示モード: 個人用アプリをアプリ ヘッダーなしで表示します。 これは、組織に公開されたアプリに対してサポートされています。
  • サポートされているチャネルの種類: アプリがサポートする非標準チャネルの種類を一覧表示します。
  • 既定のグループ機能: チーム、グループ チャット、会議など、複数のグループ機能をサポートするアプリの場合は、Microsoft Teams Store からアプリを追加するときに、ユーザーを移動する既定の機能を選択します。

• プランと価格: アプリのパートナー センターで作成したサービスとしてのソフトウェア (SaaS) オファーをリンクします。

• 管理設定:

  • アプリのカスタマイズ: 名前、 短い説明、 小さいアイコン、その他のプロパティなど、さまざまなプロパティを選択してアプリをカスタマイズします。
  • 既定でアプリをブロックする: Teams 管理者がアプリを有効にするまで、既定でユーザーに対してアプリをブロックします。

開発

[ 開発] セクションで、Visual Studio Code および Visual Studio の Microsoft 365 Agents Toolkit (以前は Teams Toolkit) を使用してアプリを開いて開発します。 詳細については、「 Microsoft 365 Agents Toolkit を使用してアプリを開発する」を参照してください。

公開

[発行] セクションで、アプリを organization または Teams Store に発行します。

• アプリ パッケージ: アプリ パッケージは、アプリの機能、必要なリソース、マニフェスト内のその他の重要な属性など、アプリの構成方法を記述します。 アプリ定義は、アプリケーションに関連付けられている構成と設定を参照します。 [アイコン] タブには、アプリで使用するアイコンが表示されます。

• アプリの検証: Microsoft がアプリ、アプリ マニフェスト、アプリの基本情報、ボットの機能を確認するために使用するテスト ケースに基づいて、アプリ パッケージを評価します。 アプリ検証ツールは、アプリ パッケージ内のエラーまたは警告を識別し、解決のためのガイドラインを提供します。

  

  アプリがいずれかのテスト ケースで不合格となった場合は、ガイドラインを確認し、Microsoft のテスト ケースの結果に基づいてアプリ パッケージに必要な更新を行います。 アプリ パッケージと検証レポートをダウンロードすることもできます。 Microsoft テスト ケースの詳細については、「 Teams ストア検証ガイドライン 」と 「コマーシャル マーケットプレース認定ポリシー」を参照してください。

  
  
  アプリ パッケージを検証する

  
  

  アプリが Teams で期待どおりに機能することを確認するには、アプリ検証ツールを使用して、アプリ パッケージを Microsoft のテスト ケースにチェックします。

  1. Teams 開発者ポータルで、左側のウィンドウから [ アプリ ] を選択し、アプリを選択します。

  2. [ Publish>App validation>Get started] (アプリの検証開始) に移動します。

     

  3. [ 検証の確認 ] の下にあるすべてのチェック ボックスをオンにし、[ 検証の開始] を選択します。

     

     注:

     • 検証を開始する前に、アプリ マニフェスト エラーを解決します。
     • 特定のアプリに対して一度に送信できる検証要求は 1 つだけです。 現在の検証が完了したら、後続の要求を開始できます。

     これで、Teams 開発者ポータルでアプリ パッケージの検証が開始されます。

     

     アプリの検証状態は次のように更新されます。

     1. 作成済み: [ 検証の開始] を選択した後。
     2. 進行中: アプリの検証が開始されます。
     3. 完了: アプリの検証が完了しました。

     検証が進行中の場合、[更新の状態] を選択して最新の検証状態を取得します。

     

  4. 検証後、アプリが合格または失敗したテスト ケースの一覧が表示されます。 利用可能なアプリの検証テスト結果の状態を以下に示します。
     

     状態	Validation	結果	説明
     成功	完了	合格	問題はありません。
     Warning	完了	合格	この問題の修正は省略可能ですが、推奨されます。
     Error	完了	失敗	アプリを正常に公開するには、この問題を修正する必要があります。
     Skipped (スキップ)	Incomplete	該当なし	検証チェックを続行できませんでした。 これは一時的な問題である可能性があります。 後でテストを再実行することをお勧めします。

     

  注:

  • アプリの検証は、ボット機能を備えたアプリに対してのみサポートされます。
  • アプリ検証ツールは、Microsoft が Microsoft Teams Store に提出する前に、Microsoft がアプリのレビューに使用するテスト ケースに基づいてアプリ パッケージを評価します。 アプリを提出する前に、エラーや警告を解決し、 アプリ申請チェックリスト をお読みください。

• 組織に発行:

  1. 開発者ポータルで、作業中の アプリ を選択します。
  2. [発行] の下の [組織に発行] に移動します。
  3. [ アプリを公開する] を選択します。

• Publish to Store:

  1. 開発者ポータルで、作業中の アプリ を選択します。
  2. [発行] の下の [ストアに発行] に移動します。
  3. [発行] を選択します。

  [Publish to store] (ストアへの公開) ページで [Download app package] ボタンを選択して、アプリ パッケージをダウンロードします。

Teams でアプリを直接テストする

デベロッパー ポータルには、アプリをテストおよびデバッグするためのオプションが用意されています。

• [概要] ページで、アプリが Teams ストアのテスト ケースに対して構成および検証されているかどうかのスナップショットを表示します。
• [ Teams でプレビュー] ボタンをクリックすると、デバッグ用に Teams クライアントでアプリがすばやく起動します。

ツールを使用してアプリ機能を作成する

開発者ポータルには、Teams アプリの主要な機能の構築に役立つツールが含まれています。 ツールを次に示します。

• アダプティブ カード エディター (プレビュー): アプリに含めるアダプティブ カードを作成してプレビューします。
• ID プラットフォーム管理 (プレビュー): アプリを Microsoft Entra ID に登録して、ユーザーがサインインして API へのアクセスを提供できるようにします。
• Teams ストア アプリの検証: Microsoft がアプリのレビューに使用するテスト ケースに対してアプリ パッケージを確認します。 [ 発行] セクションで、アプリの最新のアプリ検証ツールを使用することをお勧めします。
• エージェント ID ブループリント: Agent 365 とそのバックエンド接続の詳細を定義する再利用可能なブループリントを作成、構成、管理します。 詳細については、「 エージェント ID のブループリント」を参照してください。
• ボット管理: ユーザーと通信し、質問に応答し、変更やその他のイベントについて事前に通知する会話型ボットをアプリに追加します。

ボットを追加するには:

1. 開発者ポータルで、左側のウィンドウで [ ツール ] を選択します。

2. [ボット管理] を選択します。

   

3. [ボット管理] ページで、[ + 新しいボット] を選択します。

4. 名前を入力し、[ 追加] を選択します。

   

注:

• Microsoft Teams 開発者ポータルを使用して作成されたボットは、既定ではシングル テナントです。

• Azure Bot Service でマルチテナントとして構成されたボットは非推奨です。 ただし、 以前にマルチテナント として作成されたボットは、引き続き期待どおりに動作します。

• Microsoft Entra ID に登録されているアプリは、既定ではマルチテナント アプリケーションであり、引き続きサポートされます。 これらのアプリの登録は、Azure Bot Service のボット テナント構成とは別です Azure Bot Service でシングル テナントとして構成されたボットは、マルチテナント アプリケーションを使用できます。

• 開発者ポータルを使用してボットを作成すると、対応する servicePrincipal が Microsoft Entra ID テナントに自動的に作成されます。

• 職場または学校アカウントを使用する委任されたシナリオでは、管理者には、サポートされている Microsoft Entra ロールまたは同等のアクセス許可を持つカスタム ロールが割り当てられる必要があります。 この操作では、次の最小権限ロールがサポートされます。

  • マルチテナント アプリの場合:

    • アプリケーション管理者
    • クラウド アプリケーション管理者

  • 呼び出し元ユーザーが管理者ではないユーザーであるが、基づくアプリケーションの所有者であるシングル テナント アプリの場合、ユーザーは アプリケーション開発者 ロールを持っている必要があります。

Azure Bot Service でシングル テナントとして構成されているボットの場合、開発者はボットが正しいアクセス トークンを要求することを確認する必要があります。 詳細については、「 アクセス トークンの要求」を参照してください。

開発者ポータルから Bot Framework ポータルに移動し、アイコンやその他のプロパティを更新するようにボットを構成します。

エージェント ID ブループリント

エージェント ID ブループリントは、タスクを実行し、ユーザーまたは Microsoft 365 サービスと対話する Agent 365 のエージェントに再利用可能な構成を提供します。 各ブループリントは、エージェントがどのように構成され、バックエンドサービスに接続されるかを指定するテンプレートとして機能します。

開発者ポータルでエージェント ID ブループリントを作成して管理し、そこから派生したエージェント ID を Microsoft 365 管理センターで管理します。 エージェントを Agent 365 に拡張するための包括的なガイダンスについては、Microsoft Agent 365 SDK を使用してください。

既存のエージェント ID ブループリントを表示して使用する

開発者ポータルのエージェント ID ブループリント ツールには、テナントで使用可能な既存のブループリントの一覧が表示されます。 ブループリントはテナント内のすべてのユーザーに表示されますが、ブループリントの所有者のみが変更を加えることができます。

エージェント ID ブループリントを使用して、次の手順を実行します。

• 既存のブループリントの構成の詳細 (そのタイプとブループリント ID を含む) を表示します。
• ブループリントの構成を編集または更新します。

適切なブループリントがない場合は、新しいブループリントを作成します。

新しいエージェント ID ブループリントを作成する

1. Teams 開発者ポータルで、[ツール] に移動し、[エージェント ID ブループリント] を選択します。

   

2. [ + 新しいブループリント] を選択します。

   

3. 名前を入力し、[ 作成] を選択します。

   

   一意の エージェント ブループリント ID が自動的に生成されます。 このブループリントに基づいてエージェント ID を作成する場合は、この ID を使用します。

エージェント ID ブループリントを構成する

各ブループリントには、次の 2 つの主要な構成領域が含まれています。

1. 基本情報: ブループリントの次の基本構成を表示します。

   • エージェント ブループリント ID: ブループリントのシステム生成の一意識別子。
   • 名前: ブループリントの作成時に割り当てられた名前。

   

2. 構成: このタブで、エージェントがサービスと通信する方法を指定します。

   • [ 構成 ] タブで、[ エージェントの種類] に移動します。

     • エージェントがバックエンド サービスに接続する方法を選択します。

     • 以下のいずれかのオプションを選択します。

       エージェントの種類	説明
       none	ボットまたは API の関連付けはありません (既定)。
       ボット ベース	Teams に登録されている既存のボットを使用します。
       API ベース	カスタム API エンドポイントを使用して、エージェントの動作を定義します。

   • 選択したエージェント タイプに基づいて、次のいずれかを入力します。

     • ボット ID: [ボット ベース] を選択した場合は、登録した Teams ボットの ID を入力します。
     • バックエンド URL: API ベースを選択した場合は、バックエンド サービス エンドポイントの URL を指定します。

   • [ 保存] を選択して構成を適用します。

   • [ 元に戻す ] を選択して変更を破棄します。

   

関連項目

• Teams 管理センター
• Microsoft 365 Agents Toolkit の概要
• Microsoft Teams アプリに SaaS オファーを含める
• Teams ストア検証ガイドライン
• コマーシャル マーケットプレースの認定ポリシー