Copilot Studio で Application Insights のサポートを有効にする

Copilot Agent KitでApplication Insightsのサポートを有効にし、テレメトリの向上、パフォーマンスの監視、問題の診断を行います。 手順に従って、環境に合わせて Application Insights を設定および構成します。

前提条件

作成した Application Insights リソースとそのリソースにテレメトリを送信するように構成されたエージェント。 詳細については、Copilot StudioのコパイロットをApplication Insightsに接続するでご確認ください。

Azure ポータルで新しいアプリケーションを登録する

Copilot Agent KitでApplication Insightsのサポートを有効にするには、Microsoft Azure portalで新しいアプリケーションを登録してください。

Note

もしユーザー認証で使うためにすでにCopilot Agent Kitのアプリ登録を作成している場合は、新たに作成する代わりにApp Insights Results Enrichmentでそのアプリケーションを再利用できます。 その場合は、Azure ポータルで既存のアプリ登録に移動した後、手順 3 に進むことができます。

  1. Azure portal にサインインしてください

  2. 新しいアプリケーションを登録 し、新しいクライアント シークレットを追加します。 エージェント構成で App Insights シークレットとして使用するシークレットをメモしておきます (構成されている App Insights シークレットの場所 によって異なります)。

  3. アプリケーションのディレクトリ (テナント) ID とアプリケーション (クライアント) ID をメモして、 エージェント構成の App Insights テナント ID と App Insights クライアント ID として使用します。

  4. [概要] から [API のアクセス許可の表示] を選択します (または、サイドバーから [管理>API アクセス許可] に移動します)。

  5. アクセス許可の追加 を選択します。

  6. 組織が使用する API を選択し、Application Insights API を検索します。 一覧から Application Insights API を選択します。

  7. 委任されたアクセス許可を選択します。

  8. Data.Read を確認し、[アクセス許可の追加] に進みます。

Azure portal の [API アクセス許可の要求] ビューのスクリーンショット。

Application Insights リソースへのアクセスを提供する

登録したアプリケーションに Application Insights リソースへのアクセス権を付与します。

  1. Azure ポータルで Application Insights リソースに移動します。
  2. [アクセス制御 (IAM)] を選択します。
  3. [ロールの割り当ての追加] を選択します。
  4. 一覧から [閲覧者 ] を選択し、[ 次へ] を選択します。
  5. [メンバーの選択] を選びます。
  6. 一覧からアプリケーションを検索して選択します。 [ 選択] を選択して完了します。
  7. [ 次へ ] を選択して、[ 確認と割り当て] に移動します。
  8. アクセス許可を確認し、画面の下部にある [確認と割り当て ] を選択します。

詳細情報: Azure ポータルを使用して Azure ロールを割り当てる

AppId を探す

Application Insights リソースの AppId をメモして、 エージェント構成の App Insights アプリケーション ID として使用します。

AppId を取得するには:

  1. Azure ポータルのOverview ページから、Application Insights リソースに移動します。

  2. [JSON ビュー] を選択します。

    右上の JSON ビューが強調表示されている Microsoft Azure のリソースの [概要] ページのスクリーンショット。

  3. 開いた JSON ビューで、 properties.AppIdの値を見つけてメモします。 また、Configure>API Access から同じアプリケーション ID を見つけることもできます。

    AppId プロパティが強調表示されている Microsoft Azure の [リソース JSON] 画面のスクリーンショット。