カスタム Copilot Studio エージェントをテストするには、エージェントに接続してテストを実行するために必要な情報を含むエージェント 構成 レコードを作成します。
![Copilot Studio Kit の [エージェント構成] ビューのスクリーンショット。](media/copilot-studio-kit/kit-test-copilot.png#lightbox)
次の構成の種類がサポートされています。
- テスト自動化: カスタム エージェントの一括テストを許可します。
- 会話 KPI: 選択したカスタム エージェントの会話トランスクリプトを解析し、会話 KPI (主要業績評価指標) レコードを生成します。
- ファイル同期: SharePoint の場所からカスタム エージェント ナレッジ ベースにコンテンツをファイルとして選択的に同期できるようにします。
1 つのエージェント構成レコードで複数の構成の種類をサポートできます。 [エージェント構成] ビューには、関連する構成セクションのみが表示されます。
新しいエージェント構成レコードを作成する
[エージェント] に移動します。
新しいエージェント構成レコードを作成します。
すべての構成の種類に必要な次の情報を入力します。
列名 必須 Description 名前 イエス エージェント構成の名前。 この名前は、対象のエージェントと一致する必要はありません。 構成の種類 イエス 1 つ以上の構成の種類を選択します。 選択した構成の種類ごとに従う構成手順に従います。
Test Automation 用に新しいエージェントを構成する
[構成の種類] から [自動テスト] を選択します。
基本構成に加えて、次の情報を指定します。
列名 必須 Description リージョン イエス エージェントがデプロイされているリージョン。 適切な Direct Line API エンドポイントをターゲットにするために必要です。 トークン エンドポイント 変動 チャネル セキュリティが使用または適用されていない場合は、電子メール アプリ チャネルで使用できるトークン エンドポイントを使用します。 チャネル セキュリティ 変動 シークレットと引き換えにトークンを確実に取得できるように 、Web および Direct Line チャネルのセキュリティ が有効になっている場合は、このオプションを有効にします。
手記： ユーザー認証が有効になっている場合は、チャネル セキュリティを有効にする必要があります。シークレットの場所 変動 チャネル セキュリティがオンになっている場合は、Direct Line チャネル シークレットを格納する場所を選択します。 Dataverse はセキュリティで保護された列にシークレットを格納しますが、Azure Key Vault はシークレット型の環境変数を使用し、シークレットを Azure Key Vault に格納します。 シークレット 変動 Dataverse がシークレットの場所として選択されている場合、この列には Direct Line チャネル シークレットが格納されます。 環境変数 変動 Key Vault がシークレットの場所として選択されている場合、この列には、Azure Key Vault シークレットにリンクするシークレット型の環境変数のスキーマ名が格納されます。 「Azure Key Vault でシークレットを構成する」の手順に従います。 ユーザー認証 変動 ユーザー認証が必要な場合は、[Entra ID v2] を選択します。 Microsoft 認証を使用するには、「Copilot Studio Kit テスト用に Microsoft 認証を設定する」の手順に従います
注:ユーザー認証が有効になっている場合は、チャネル セキュリティを有効にする必要があります。クライアント ID 変動 カスタム エージェントのエンド ユーザー認証を有効にするために作成されたアプリケーションのアプリケーション (クライアント) ID を入力します。 詳細については、「 Microsoft Entra ID を使用してユーザー認証を構成する」を参照してください。 テナント ID 変動 カスタム エージェントのエンド ユーザー認証を有効にするために作成されたアプリケーションのテナント ID を入力します。 シークレットの場所 (ユーザー認証) 変動 [ユーザー認証] が選択されている場合は、クライアント シークレットを格納する場所を選択します。 Dataverse はセキュリティで保護された列にシークレットを格納しますが、Key Vault にはシークレット型の環境変数が必要であり、シークレットは Azure Key Vault に格納されます。 クライアント シークレット 変動 認証サポートを有効にするときに作成したクライアント シークレットを入力します。 たとえば、 KitAuthApp secretと指定します。Scope 変動 認証サポートを有効にするときに作成したカスタム スコープを入力します。 フル スコープ URI 形式を使用します。例: api://1234-4567/scope.name。Azure Application Insights で強化する 変動 このオプションを有効にすると、Azure Application Insights テレメトリ データを使用して、Generative Answers テストのテスト結果を強化できます。
手記： Application Insights からテスト結果を強化するには、Application Insights リソースと同じテナントにアプリを登録する必要があります。 Application Insights リソースとアプリケーションは、テストするカスタム エージェントとは異なるテナントに配置できます。 アプリケーションを登録し、Application Insights リソースに必要な情報を取得する方法について説明します。 カスタム エージェントが Application Insights リソースにテレメトリを送信するように設定されていること、および Copilot Studio Kit のエージェント構成と一致していることを確認します。 カスタム エージェントを Application Insights に接続する方法について説明します。App Insights クライアント ID 変動 Application Insights リソースからデータを読み取るアクセス許可を持つアプリケーションのアプリケーション (クライアント) ID を入力します。 App Insights アプリケーション ID 変動 Application Insights リソースの AppId を 入力します。 AppId を見つける手順を参照してください。 App Insights 秘密の場所 変動 Application Insights アプリケーション シークレットを格納する場所を選択します。 Dataverse はシークレットをセキュリティで保護された列に格納しますが、Azure Key Vault にはシークレット型の環境変数が必要であり、シークレットは Azure Key Vault に格納されます。 App Insights テナント ID 変動 Application Insights リソースとアプリケーションのテナント ID を入力します。 App Insights シークレット 変動 Dataverse がシークレットの場所として選択されている場合、この列には App Insights アプリケーション シークレットが格納されます。 App Insights 環境変数 変動 Key Vault がシークレットの場所として選択されている場合、この列には、App Insights アプリケーション シークレットにリンクするシークレット型の環境変数のスキーマ名が格納されます。 会話のトランスクリプトを使用したエンリッチメント いいえ Dataverse に格納されている会話トランスクリプトのデータを使用してテスト結果を強化するには、このオプションを有効にします。
手記：Copilot Studio Kit が他の Power Platform 環境から会話トランスクリプト レコードを取得するには、ソリューションのセットアップ時に使用される Microsoft Dataverse 接続で、ターゲット環境のReadテーブル レコードにConversationTranscriptアクセスできる必要があります。 ターゲットにできるのは、同じテナント内の環境のみです。Dataverse URL 変動 会話トランスクリプトでエンリッチが有効になっている場合は、Dataverse 環境の URL ( https://org123.crm.dynamics.comなど) を入力します。 Copilot Studio の URL は 、[設定] (
) から [ セッションの詳細] を選択して取得できます。 インスタンス URL を探します。完全なトランスクリプトのコピー いいえ 会話トランスクリプトを使用したエンリッチメントが有効になっている場合、このオプションでは、完全な Conversation Transcript JSON が添付ファイルとしてテスト結果レコードにコピーされ、さらに分析されます。 生成された回答の分析 いいえ このオプションを有効にすると、大規模言語モデル (LLM) によって AI によって生成されたテストが分析されます。 応答をサンプルの回答または検証命令と比較します。 生成 AI プロバイダー 変動 生成された回答の分析が有効になっている場合は、分析に使用する LLM モデルを指定します。
手記： 現時点では、AI Builder のみがサポートされています。保存 を選択します。
Conversation KPI 用に新しいエージェントを構成する
[構成の種類]から[会話 KPI]を選択します。
基本構成に加えて、次の情報を指定します。
列名 必須 Description Dataverse URL イエス 会話トランスクリプトとエージェントが配置されているデータバース URL。 例: https://organizationname.crm.dynamics.comエージェント ID イエス 対象とするカスタム エージェントのボット ID。 この値は、Copilot Studio の [設定] ( ) で [ セッションの詳細] を選択することで確認できます。
Copilot ID を探します。完全なトランスクリプトのコピー いいえ トランスクリプト ビジュアライザー (Conversation KPI レコードの [トランスクリプト] タブ) で会話を検査する場合は必須です。 有効にすると、会話の完全なトランスクリプトがコピーされ、KPI レコードに関連付けられます。 追跡対象の変数 いいえ 会話から追跡するカスタム変数を最大 5 つ指定できます (カスタム Net プロモーター スコアや NPS など)。 形式は JSON 配列です。
例:[ Activity. Channel, Activity.Type ]エージェント コンポーネント いいえ トピック、ナレッジ ソースなど、指定されたエージェントのコンポーネントが設定された読み取り専用フィールド。 保存 を選択します。
ファイル同期用に新しいエージェントを構成する
[構成の種類] から [ファイル同期] を選択します。
基本構成に加えて、次の情報を入力します。
列名 必須 Description エージェント ID (ボット ID) イエス 対象とするカスタム エージェントのボット ID。 この ID は、Copilot Studio の [設定] ( ) で [ セッションの詳細] を選択して確認できます。
Copilot ID を探します。Dataverse URL イエス カスタム エージェントが配置され、コンテンツが同期される Dataverse URL。 たとえば、 https://organizationnname.crm.dynamics.comと指定します。 セッションの詳細から Copilot Studio の URL を取得します。 インスタンス URL を探します。少なくとも 1 つの ファイル インデクサー構成 を追加し、次の情報を入力します。
列名 必須 Description 名前 イエス ファイル インデクサー構成の名前。 たとえば、HR ドキュメントです。 エージェントの構成 イエス このレコードが属するエージェント構成。 エージェント構成ビューを使用して新しいレコードを作成すると、この値が自動的に設定されます。 サイト アドレス イエス コンテンツを同期する SharePoint サイトのアドレス。 例: https://organizationname.sharepoint.com/sites/sitenameライブラリ名 イエス コンテンツを同期する SharePoint サイト内のライブラリ。 例: ドキュメント 入れ子になった項目を含める イエス コンテンツの同期が、指定した正確な場所 (いいえ) に制限されているか、またはその場所の子項目も同期に含まれるかどうかを指定します (Yes、default)。 フォルダーへのエントリの制限 いいえ 必要に応じて、同期するライブラリ内のフォルダーを指定します。 例: /HR-documents SharePoint ファイル フィルター クエリ いいえ 必要に応じて、同期するファイルを選択するときに使用するフィルターを指定します。 追加のフィルター処理を行わない場合は空のままにします。 例: PublicContent eq 'true' SharePoint ページを含める いいえ 必要に応じて、SharePoint ページを同期に含めます。 SharePoint Pages フィルター クエリ いいえ 必要に応じて、同期するページを選択するときに使用するフィルターを指定します。 追加のフィルター処理を行わない場合は空のままにします。 例: PublicContent eq 'true' 必要に応じて、コマンド バーから [接続の検証] を選択して、ファイル インデクサーの構成を検証できます。
保存 を選択します。
