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

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

概要

[ 概要 ] セクションでは、次のコンポーネントを表示してアプリを管理できます。

• ダッシュボード

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

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

    

• 分析

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

Configure

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

[ 構成 ] セクションでは、アプリを管理およびアクセスするための次のコンポーネントを表示できます。

• 基本情報: このセクションでは、 アプリ名、 アプリ ID、 説明、 バージョン、 開発者情報、 アプリ URL、 アプリケーション (クライアント) ID、 Microsoft Partner Network 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. [構成>App パッケージ エディター] に移動します。

     

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

     

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

     

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

     

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

     

     次に、開発者ポータルでファイルが確認され、発行する前に解決する必要があるエラーが特定されます。

• アクセス許可: このセクションでは、 アプリのデバイスのアクセス許可、 チームのアクセス許可、 チャット/会議のアクセス許可、 ユーザーのアクセス許可 を付与できます。

  注:

  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 ストアからアプリを追加するときにユーザーを移動する既定の機能を選択します。

• 環境

  ローカル ランタイムから運用環境へのアプリの移行に役立つ環境とグローバル変数を構成できます。 グローバル変数は、すべての環境で使用されます。

  環境を設定するには、次の手順に従います。

  1. 開発者ポータルで、作業している アプリ を選択します。
  2. [詳細設定] セクションの [環境] に移動します。
  3. [+ 環境の追加] を選択します>[追加] を選択します。

  • グローバル変数

    1. [ グローバル変数の追加] を 選択して、環境の構成変数を作成します。

    グローバル変数を使用するには:

    アプリ構成を設定するには、ハードコーディングされた値の代わりに変数名を使用します。

1. 開発者ポータル内の任意のフィールドに「 {{ 」と入力します。 ドロップダウンが表示され、選択した環境用に作成したすべての変数とグローバル変数が表示されます。
2. アプリ パッケージをダウンロードする前 (たとえば、Teams ストアに発行する準備をしている場合)、使用する環境を選択します。 アプリ構成は、環境に基づいて自動的に更新されます。

• プランと価格: アプリのパートナー センターで作成したサービスとしてのソフトウェア (SaaS) オファーをリンクします。
• 管理設定:
  • アプリのカスタマイズ: 名前、 短い説明、 小さいアイコン、その他のプロパティなど、さまざまなプロパティを選択してアプリをカスタマイズします。
  • 既定でアプリをブロックする: Teams 管理者がアプリを有効にするまで、ユーザーのアプリを既定でブロックします。

開発

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

公開

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

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

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

  

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

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

  
  

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

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

  2. [ 発行>App 検証>Get Started に移動します。

     

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

     

     注:

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

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

     

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

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

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

     

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

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

     

  注:

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

• 組織に発行する:

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

• ストアに発行する:

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

  [ストアに発行] ページの [アプリ パッケージのダウンロード] ボタンを選択して、アプリ パッケージをダウンロードします。

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

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

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

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

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

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

ボットを追加するには:

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

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

   

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

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

   

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

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

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

開発者ポータルでエージェント ID ブループリントを作成および管理し、Microsoft 365 管理 センターでそれらから派生したエージェント ID を管理します。 エージェントを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 ストア検証ガイドライン
• コマーシャル マーケットプレース認定ポリシー