Copilot Agent Kitのインストール

Copilot Agent Kitは、Copilot Studioエージェントのテストと評価のためのオープンソースツールキットです。 たとえば、テスト ケースの定義、ユーザー クエリのシミュレート、エージェントの応答の検証に役立ちます。 この記事では、マーケットプレイスやGitHubからのキットインストール手順、展開後の手順、設定オプションをステップバイステップで紹介します。

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

GitHubからCopilot Agent Kitをインストールしたい場合は、「GitHubからInstall Copilot Agent Kit」へスキップしてください。

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

マーケットプレイスからCopilot Agent Kitを展開するには、以下の手順に従ってください:

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

Copilotエージェントキットの設置が始まります。

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

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

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エージェントキットの最新バージョンにアップグレードするには、以下の手順に従ってください:

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

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

これらの設定手順は、マーケットプレイスでCopilotエージェントキットをインストールした場合でも、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は環境からエージェントの情報を収集します。 すべての環境に対するシステム管理者レベルのアクセス許可が必要です。

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

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

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エージェントキットの環境が選択されていることを確認してください。
4. [ソリューション] を選択します。
5. Copilotエージェントキットを選択してください。
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でのエージェント設定方法や、Conversation 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」で検索し、Typeコード(モデル駆動型アプリではない)のものを探してください。
4. 3 つのドット (...) を選択し、アプリ名の横にある [共有 ] を選択します。
5. アクセスが必要なユーザーまたはセキュリティ グループを検索して追加します。
6. [ 共有] を選択して確定します。

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

次のステップ