次の方法で共有

Copilot Studio キットをインストールする

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

注

Copilot Studio Kit をダウンロードしてインストールする前に、すべての前提条件を満たしていることを確認します。

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キットのインストールが開始されます。

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

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

  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 の 最新バージョンmanaged ソリューションをダウンロードします。

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. インポート を選択します。

注

Copilot Studio Kit のアップグレード中に、次のエラーが発生する可能性があります。Solution "Power CAT Copilot Studio Kit" のインポートに失敗しました: ImportAsHolding で例外が発生して失敗しました。エンティティ cat_CopilotTestRun から属性 cat_copilottestrunid を削除できません。これはその属性がユーザー設定フィールドではないためです。

この問題は既知であり、調査中です。 回避策として、アップグレードを適用する前にステージングします。 詳細については、 ソリューションのアップグレードまたは更新に関するページを参照してください。

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

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

ヒント

Copilot Studio Kit には、接続参照、環境変数、クラウド フローを構成するためのセットアップ ウィザードが含まれています。 セットアップウィザードの使い方について詳しく学びましょう。

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/

Microsoft Entra ID コネクタを使用した HTTP のベースリソース URL としてのライセンスホスト URL の構成を示すスクリーンショット

フローを有効にする

注

関連するフロー（名前は SharePoint Synchronization で始まります）を有効にする前に、SharePoint同期を使用する場合、SharePoint同期を構成してください。

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

埋め込み会話 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. (省略可能)アプリを ブックマーク します。

Copilot Studio Kit アプリを共有する

アプリが正常に起動したことを確認した後、所有者 (または Kit をインストールしたシステム管理者) は、Copilot Studio Kit アプリをチームと共有する必要があります。

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

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

次のステップ

ユーザーとチームを構成する

  • Last updated on