Copilot Studio Kit をインストールする

Copilot Studio Kit は、Copilot Studio エージェントをテストおよび評価するためのオープンソース のツールキットです。 たとえば、テスト ケースを定義したり、ユーザー クエリをシミュレートしたり、エージェントの応答を検証したりできます。 この記事では、MarketplaceorGitHub からキットをインストールする手順と、デプロイ後の手順と構成オプションについて説明します。

Marketplace から Copilot Studio Kit をインストールする

GitHubからCopilot Studio Kitをインストールしたい場合は、GitHubからCopilot Studio Kitをインストールするにスキップしてください。

マーケットプレイスから展開

Marketplace から Copilot Studio Kit をデプロイするには、次の手順に従います。

1. MarketplaceのCopilot Studio Kit に移動します。
2. [今すぐ入手する] を選択します。
3. 必要に応じてサインインします。
4. Install Copilot Studio Kit ビューで、Copilot Studio Kit を展開する環境を選択します。
5. 使用条件とステートメントを確認します。 同意する場合は、ボックスをオンにして [インストール] を選択 します。

Copilot Studio Kit のインストールが開始されます。

展開後のステップ(マーケットプレイス)

インストールが完了したら、次の展開後の手順に従います。

1. Power Apps にサインインします。
2. ソリューションに移動します。
3. 既定のソリューションを選択します。
4. [接続参照] を選択します。
5. Copilot Studio Kit - Dataverseを見つけて編集用に開きます。
6. すべての必須フィールドが入力され、選択した接続が有効であることを確認します。 必要に応じて、Dataverse への新しい接続を作成します。
7. 保存を選びます。
8. 追加の構成手順とオプションの構成手順に従います。

GitHubから Copilot Studio Kit をインストールする

GitHubから Copilot Studio Kit をインストールするには、次の手順に従います。 Marketplace からインストールする場合は、 Marketplace から Copilot Studio Kit をインストールするに移動します。

最新のGitHub リリースをダウンロードする

Power CAT Copilot Studio Kit の最新バージョンの管理されたソリューションをダウンロードします。

CopilotStudioKit マネージド zip ファイルをインストールする

Copilot Studio Kit マネージド ソリューションをインストールするには:

1. Power Apps にサインインします。
2. Copilot Studio Kit をインストールする環境を選択します。
3. ソリューションに移動します。
4. [ ソリューションのインポート] を選択します。
5. を選択し、を参照します。
6. CopilotStudioKit*_managed.zipファイルを選択します。
7. 次へを選択します。
8. ソリューション情報を確認したら、[ 次へ] を選択します。
9. メッセージが表示されたら、必要な 接続を作成し、[インポート] を選択 します。
10. 会話 KPI レポートの値は、現時点では as-is のままにしておきます。 これらの値は後で更新できます。
11. インポート操作が完了するまで待ちます。

既存のソリューションをアップグレードする (GitHub)

以前のバージョンの Copilot Studio Kit をインストールし、最新バージョンにアップグレードする場合は、次の手順に従います。

1. Power Apps にサインインします。
2. Copilot Studio Kitをアップグレードする環境を選択します。
3. ソリューションに移動します。
4. [ ソリューションのインポート] を選択します。
5. を選択し、を参照します。
6. [CopilotStudioKit*_managed.zipを選択します。
7. 次へを選択します。 Power Appsは、このアップグレードが既存のマネージド ソリューションであることを認識します。
8. [次へ] を選択して、既存のソリューションをアップグレードすることを確認します。
9. 会話 KPI レポートの値は、現時点では as-is のままにしておきます。 これらの値は後で更新できます。
10. インポート を選択します。

追加の構成手順とオプションの構成手順

これらの構成手順は、Marketplace から Copilot Studio Kit をインストールしたか、GitHubにインストールしたかに関係なく適用されます。

SharePoint同期の構成

次の手順は省略可能であり、SharePoint 同期機能を使用する場合にのみ必要です。 これらの値は、機能を使用する前にいつでも設定できます。

ソース SharePoint サイトに接続を設定します。 コンテンツが同期するターゲット カスタム エージェントの Dataverse インスタンスに Dataverse URL をポイントします。

次の手順に従うか、Setup ウィザードを使用してSharePoint接続参照を構成できます <>

SharePoint同期機能を使用するには:

1. この記事で前述したCopilot Studio Kitをインストールします。
2. Power Apps にサインインします。
3. ソリューションに移動します。
4. 既定のソリューションを選択します。
5. [接続参照] を選択します。
6. Copilot Studio Kit - SharePoint接続参照を見つけて、編集用に開きます。
7. すべての必須フィールドが入力され、選択した接続が有効であることを確認します。 必要に応じて、SharePointへの新しい接続を作成します。
8. 保存を選びます。

詳細情報: Copilot Studio Kit でエージェント構成する方法 (ファイル同期用に新しいエージェントを構成する方法などについて説明します。

エージェント インベントリの構成

次の手順は省略可能であり、 エージェント インベントリ 機能を使用する場合にのみ必要です。 これらの値は、機能を使用する前にいつでも設定できます。

ソリューション内の接続参照によって、エージェントの可視性が制御されます。 他のアカウントを使用することはできますが、これらのアクセス許可を使用して完全な可視性を得ることができます。

• Copilot Studio Kit - Power Platform for Admins は、テナント内の環境の一覧をフェッチします。 Power Platform 管理者レベルのアクセス許可が必要です。
• Copilot Studio Kit - Dataverse は、環境からエージェント情報を収集します。 すべての環境に対するシステム管理者レベルのアクセス許可が必要です。

これらの手順に従うか、 セットアップウィザー ドを使ってエージェントインベントリの接続参照を設定することができます。

エージェント インベントリ機能を使用するには:

1. この記事で前述したCopilot Studio Kitをインストールします。
2. Power Apps にサインインします。
3. ソリューションに移動します。
4. 既定のソリューションを選択します。
5. [接続参照] を選択します。
6. Copilot Studio Kit - Power Platform for Admins 接続リファレンスを見つけて、編集用に開きます。
7. すべての必須フィールドに入力し、選択した接続が有効であることを確認します。
8. 保存を選びます。
9. Copilot Studio Kit - Dataverse 接続参照を見つけて、編集用に開きます。
10. すべての必須フィールドに入力し、選択した接続が有効であることを確認します。
11. 保存を選びます。

使用状況メトリックを有効にする

エージェント インベントリでオプションの使用状況メトリックを有効にするには、次の手順を実行します。

1. 環境内でコネクタ HTTP With Microsoft Entra ID (事前認証済み) が許可されていることを確認します。
2. AgentInventoryUsage*_managed.zip ファイルを Power CAT Copilot Studio Kit GitHub リポジトリからインポートします。
3. インポート プロセス中に、ライセンス ホスト URL を使用して接続を作成します。 https://licensing.powerplatform.microsoft.com/

フローを有効にする

Copilot Studio Kit に含まれるクラウド フローを有効にするには、これらの手順に従ったり、Setup ウィザードを使用したりしないでください。

1. この記事で前述したCopilot Studio Kitをインストールします。
2. Power Automate にサインインします。
3. Copilot Studio Kit を使用する環境が選択されていることを確認します。
4. [ソリューション] を選択します。
5. Copilot Studio Kit を選択します。
6. クラウド フロー を選択します。
7. すべてのフローが有効になっていることを確認します (状態 = オン)。
8. 次の順序で、有効になっていないすべてのフローを有効にします。
   1. 孫で終わるフロー。
   2. 子で終わるフロー。
   3. 必要に応じて、任意の順序で残りのフローを実行します。

コンプライアンスハブの設置

Compliance Hubを設定するには、「Copilot Studio Kit Compliance Hub のセットアップと構成手順」に従います。 コンプライアンスハブはエージェントインベントリが必要です。

埋め込み会話 KPI ダッシュボードを構成する

これらの手順は、埋め込み 会話 KPI ダッシュボードを使用する場合にのみ必要です。

手順中に、次の値を書き留めます。

• ワークスペース名
• ワークスペース GUID
• レポート名
• レポート GUID

レポートを発行する

Conversation KPI レポートを発行するには:

1. この記事で前述したCopilot Studio Kitをインストールします。

2. Conversation.KPIs.zipを Power CAT Copilot Studio Kit GitHub リポジトリからダウンロードします。

3. zip ファイルのコンテンツを抽出します。

4. Power BI デスクトップ アプリケーションで Conversation KPIIs.pbit ファイルを開きます。

5. 表示されるダイアログで [ 環境の URL ] として Dataverse URL を入力し、[ 読み込み ] を選択します (たとえば、 org3c23948.crm.dynamics.com、 https:// プレフィックスなし)。

   ダイアログボックスが表示されない場合は、ホーム>>に環境 URL を入力します。

6. データを更新し、必要に応じてサインインします。

7. ワークスペースに保存して発行します。

8. レポート名とワークスペース名を書き留めます。

9. Power BI にサインインします。

10. 発行したレポートを開き、URL に ワークスペース GUID と レポート GUID を 書き留めます。

    "マイ ワークスペース" に発行した場合、ワークスペース GUID は 00000000-0000-0000-0000-000000000000。

11. 3つの点(...)を選択し、次に 「意味モデルを見る」と表示します。

12. File>を開きます。

13. データ ソースの資格情報に問題がないことを確認します。 サインインして問題を解決します。

14. [更新] に移動し、 更新 スケジュールを設定します。

レポート環境変数を更新する

埋め込み会話 KPI ダッシュボードを設定するには、関連する環境変数を正しい識別子で更新します。 これらの手順に従うか、セットアップウィザードを使うことができます。

1. Power Apps にサインインし、Copilot Studio Kit をインストールした環境を選択します。
2. ソリューション>既定のソリューションを選択します。
3. 環境変数 を選択する。
4. 会話 KPI レポートを見つけて選択します。
5. 既定値のプレースホルダーを、発行プロセス中に書き込んだワークスペース名、ワークスペース GUID、レポート名、およびレポート GUID の値に置き換えます。
6. 保存を選びます。

詳細情報: Copilot Studio Kit でエージェントを構成する方法について学びます。これには、会話 KPI のための新しいエージェントを構成する方法も含まれます。

Copilot Studio Kit アプリにアクセスする

Copilot Studio Kit アプリにアクセスするには:

1. Power Apps にサインインし、Copilot Studio Kit をインストールした環境を選択します。
2. アプリに移動します。
3. Power CAT Copilot Studio Kit を見つけて選択します。
4. [再生] を選択します。
5. (省略可能)アプリを ブックマーク します。

次のステップ