Copilot Agent Kit のホーム ページからセットアップ ウィザードにアクセスします。 セットアップ ウィザードでは、次のような展開後のほとんどの手順について説明します。
- 前提条件の確認
- 接続参照と環境変数の設定
- クラウド フローの有効化
[次へ] または [戻る] を選択して、手順を進みます。
Important
ウィザードに含まれていない手順については、 セットアップ ウィザードで使用できない展開後の手順を確認します。
Prerequisites
前提条件の確認 ステップでは、セットアップ ウィザードが環境に必要なすべての依存関係がインストールされていることと、必要な設定が正しく構成されていることを確認します。
接続参照情報
[接続参照] ステップでは、セットアップ ウィザードに、キットで使用されているすべての接続参照が表示されます。 必要に応じて、各接続参照を選択して更新します。
キットには以下の接続参照が含まれています。
| Name | Description | Notes |
|---|---|---|
| Copilot Agent Kit - Dataverse | Copilot Agent Kit の Microsoft Dataverse 接続参照 | 必須 |
| Copilot エージェント キット - Power Platform 管理者向け | エージェント インベントリ機能に表示される環境を一覧表示する | エージェント インベントリ に必須 |
| Copilot エージェント キット - SharePoint | SharePoint 同期 で使用 | SharePoint 同期に必須 |
環境変数
環境変数の構成 ステップでは、セットアップ ウィザードが Copilot Agent Kit で使用されるすべての環境変数を一覧表示し、それぞれの用途、推奨される構成、および設定を行うタイミングを説明します。 このビューから直接環境変数を設定または更新することもできます。
セットアップウィザードは、キット全体で共有されるコア環境変数をカバーしています。 Compliance HubやエージェントごとのAzure Key Vault秘密など、より豊かな構成を持つ機能は、Feature-specific environment variablesにリンクされた機能ページで説明されている独自の環境変数を維持します。
キットには以下のコア環境変数が含まれています:
| Name | Description | Notes | 使用場所 |
|---|---|---|---|
| エージェント トークン エンドポイント | ウェブチャットプレビューを動かすCopilot Studioカスタムエージェントのトークンエンドポイントです。 Copilot Studioのエージェントのチャンネル設定から値をコピーします。 | オプション。 この値を設定しなければ、キットはエミュレーターにフォールバックします。 | アダプティブ カード ギャラリー、WebChat プレイグラウンド |
| 会話のKPIレポート | 組み込み型Conversation KPIsダッシュボード用のPower BIレポートおよびワークスペースの詳細(ワークスペース名、ワークスペースGUID、レポート名、レポートGUID)を保持します。 | 組み込みダッシュボードを使う場合のみ必要です。 報告書を公開した後に更新してください。 | 埋め込み会話 KPI ダッシュボードを構成する |
| Dataverse の URL | Copilot StudioのカスタムエージェントをホストするDataverseインスタンスのURLです。同期コンテンツのターゲット環境です。 例: https://orgname.crm.dynamics.com。 |
SharePoint同期を使う場合は必須です。 | SharePoint同期 |
| Azure アプリケーション Insights エンリッチメントの遅延時間 (分) | テスト実行後にAzure アプリケーション Insightsから追加データを取得するまでにどれくらい待つのか。 テレメトリが遅れる場合は増やし、反復速度を速くするために減らしましょう。 | デフォルト:5分。 エージェント設定で App Insights エンリッチメントが有効になっている場合にのみ使用されます。 | エージェントの設定、 Application Insightsを有効にする |
| 会話トランスクリプト エンリッチメントの遅延時間 (分) | テストラン後にDataverseの会話記録から追加データを取得する前にどれくらい待つか。 | デフォルト:60分。 エージェント構成で転写本濃縮が有効化された場合にのみ使用されます。 | エージェントを構成する |
| 1つのインベントリを有効にする | エージェント・インベントリが使用するデータソースを制御します。 統合されたOne Inventoryのデータソースについては 「はい (推奨)」に設定し、Power Platform for Admins V2接続が必要です。 標準の環境ごとのコレクションに戻るために 「いいえ 」に設定します。 | エージェントインベントリに必須。 デフォルト: はい。 | エージェントインベントリのデータ収集モード |
| 価値コンポーネントを有効にする | エージェント価値ダッシュボードに自動で入力されるエージェント価値分類フローを有効にします。 コンポーネントをオンにするには 「はい 」に設定してください。 | エージェントバリューダッシュボードを使う場合にのみ必要です。 関連するすべての Power Automate フローも有効になっている必要があります。 | エージェント価値の測定 |
特徴固有の環境変数
一部の機能はセットアップウィザードのコアリストに表示されていない独自の環境変数を提供します。 何を設定し、なぜ設定すべきかの詳細なガイダンスについては、対応するページをご覧ください。
- コンプライアンスハブ:13の環境変数をクリティカル、推奨、デフォルトカテゴリ(App ID、コンプライアンス管理者グループID、インスタンスURL、Maker Team ID、SLA設定など)にまとめています。 詳細 は「Compliance Hubのセットアップと設定」をご覧ください。
- Azure Key Vaultのエージェントごとの秘密:DataverseではなくKey Vaultにエージェント秘密を保存する場合、シークレットごとにsecretのタイプの環境変数を1つ作成します。 詳しくは「Azure Key Vault でシークレットを構成する」をご覧ください。
フローのアクティブ化
フローのアクティブ化 ステップでは、すべての Copilot Agent Kit フローの状態を確認し、どれを有効にするか選択できます。 一部のフローでは、SharePoint 同期など、アクティブ化する前に関連する接続参照を構成する必要があります。
各フローには、サポートされている機能を反映するプレフィックスが付いているため、簡単に識別できます。 使用する予定の機能に対応するフローのみを有効にします。
セットアップ ウィザードで展開後の手順を使用できない
次の展開後の手順は、セットアップ ウィザードでは使用できません。
- 会話 KPI サンプル ダッシュボードの公開およびデータ更新のスケジュール設定
- エージェント インベントリでの使用状況メトリックの有効化
- テスト自動化に必要なアプリの登録の作成 (ユーザー認証 や Application Insights など)