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

Copilot Agent Kit は、Copilot Studio エージェントのテストと評価を行うためのオープンソース ツールキットです。 たとえば、テスト ケースの定義、ユーザー クエリのシミュレート、エージェントの応答の検証に役立ちます。 この記事では、マーケットプレース または GitHub からキットをインストールする詳細な手順と、展開後の手順および構成オプションについて説明します。

マーケットプレースから Copilot Agent Kit をインストールする

GitHub から Copilot Agent Kit をインストールする場合は、GitHub から Copilot Agent Kit をインストール に進んでください。

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

Copilot Agent Kit をマーケットプレースから展開するには、以下の手順に従います。

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

Copilot Agent Kit のインストールが始まります。

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

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

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

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

手順に従って GitHub から Copilot Agent Kit をインストールします。 マーケットプレースからインストールする場合は、マーケットプレースから Copilot Agent Kit をインストールする に進んでください。

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

Power CAT Copilot Agent Kitのマネージドソリューションの最新バージョンをダウンロードしてください。

Copilot Agent Kit マネージド zip ファイルをインストールします

Copilot Agent Kit 管理ソリューションをインストールするには:

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

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

最新バージョンの Copilot Agent Kit にアップグレードするには、以下の手順に従います。

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

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

これらの設定手順は、Copilot Agent Kit をマーケットプレイスまたは GitHub からインストールした場合のどちらにも適用されます。

SharePoint 同期を構成する

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

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

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

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

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

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

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

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

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

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

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

接続参照を設定した後、Agent Inventory内で環境スコープ、エージェントタイプ、環境グループ、インベントリオプション、同期スケジュールを設定します。 詳細については、「 エージェント インベントリの構成」を参照してください。

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

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

フローを有効にする

Copilot Agent Kit に含まれるクラウド フローを有効にするには、次の手順に従うか、セットアップ ウィザード を使用します。

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

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

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

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

埋め込み 会話 KPI ダッシュボードを使用する場合にのみ、次の手順に従います。

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

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

レポートを公開する

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

1. この記事の前半で説明した Copilot Agent Kit をインストールします。

2. Power CAT Copilot Agent KitのGitHubリポジトリから Conversation.KPIs.zip をダウンロードしてください。

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

4. Power BI Desktop アプリケーションで Conversation KPI.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 Agent Kit をインストールした環境を選択します。
2. ソリューション>既定のソリューションを選択します。
3. 環境変数 を選択する。
4. 会話 KPI レポートを見つけて選択します。
5. 既定値のプレースホルダーを、発行プロセス中に書き込んだワークスペース名、ワークスペース GUID、レポート名、およびレポート GUID の値に置き換えます。
6. 保存を選びます。

Copilot Agent Kit でのエージェントの構成方法 (会話 KPI 用の新しいエージェントを構成する 方法を含む) について説明します。

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

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

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

Copilot Agent Kit アプリを共有する

アプリが正常に起動したことを確認したら、所有者 (またはキットをインストールしたシステム管理者) は Copilot Agent Kit アプリをチームと共有してください。

1. Power Apps にサインインします。
2. [アプリ] を選択します。
3. 「Copilot Agent Kit」を検索し、種類が コード (モデル駆動型アプリではない) のアプリを見つけます。
4. 3 つのドット (...) を選択し、アプリ名の横にある [共有 ] を選択します。
5. アクセスが必要なユーザーまたはセキュリティ グループを検索して追加します。
6. [ 共有] を選択して確定します。

詳細については、「 キャンバス アプリを組織と共有する」を参照してください。

次のステップ