Copilot Agent Kitのエージェント・インベントリを使ってエージェントを監視

エージェントインベントリ機能は、管理者に対し、組織内のすべてのCopilot Studioカスタムエージェントおよび宣言エージェントを環境全体でテナント全体で可視化します。 エージェントインベントリのデータには、ライフサイクルおよび所有権のメタデータ、構成および能力導入のシグナル、ガバナンス指標、使用指標が含まれます。

Dashboard

エージェントインベントリダッシュボードは、テナント全体の要約とインベントリへのドリルスルーナビゲーションを提供します。 エージェントのグリッドでフィルター済みビューを開くために、タイル、チャート、またはリストアイテムを選択します。

在庫の背景

ダッシュボード上部のステータス行はインベントリの現在の状態を示しています:

• インベントリが最新の状態であるか、空であるか、または同期が進行中であるかどうか。
• 詳細な構成で充実した記録の割合。
• 情報が限られているエージェントの数。
• 同期された環境の数。
• 利用可能な場合は、最後に成功した同期時間です。

ポートフォリオ指標

メトリックタイルは、インベントリの重要な区間に直接ジャンプするのに役立ちます:

• エージェントの数
• 提供
• 自律エージェント
• 下書きエージェント
• 知識を持つエージェント

そのセグメントにフィルターをかけたエージェントのグリッドを開くタイルを選びます。 Powered by TileはエージェントをStandard、GitHub Copilot、Copilot Chatなどのカテゴリに分類します。

分析とガバナンス

ダッシュボードにはパターンやリスクを見つけるのに役立つチャートやリストも含まれています:

• ポートフォリオの成長は 6か月および12か月の範囲で行われます。
• 認証の配布。
• 管理者の審査を必要とするガバナンスの優先事項。
• ポートフォリオのステータス 分布。
• 機能の高度化されたエージェントへの導入。
• エージェント数でランキングされたトップ環境。
• 注意が必要なレコードについて、エージェントが確認します。

パーセンテージは、設定された接続IDがエージェントデータや詳細な設定を取得できる環境によって異なります。 詳細については、データ収集モードをご覧ください。

すべての代理店を閲覧

ダッシュボードから「 全在庫を見る 」を選択してエージェントのグリッドを開きます。 グリッドを使って在庫データを見つけ、グループ化し、エクスポートできます。

任意の列でフィルタリング、ソート、グループ化ができ、必要に応じて列を追加・削除してグリッドを調整し、現在のビューをExcelにエクスポートできます。

エージェントの詳細

グリッドからエージェント名を選択して エージェントの詳細を開きます。 ヘッダーはエージェントの識別、環境コンテキスト、ライフサイクルステータス、所有権、利用可能なアクションを示します。 情報バナーには、レコードに Dataverse による完全な拡張があるか、または限られた構成の詳細のみがあるかが表示されます。

[概要] タブ

概要タブでは、エージェントの要約や環境情報、ガバナンス・ポスチュールとシグナル、使用履歴が存在する場合の使用スナップショットが表示されます。 AI生成の説明が有効で、かつエージェントがGitHub Copilot エージェントの対象であれば、AI生成の説明も表示されます。

[コンポーネント] タブ

コンポーネントタブは、エージェントのコンポーネントデータが利用可能である場合にのみ表示されます。 このタブを使って 、コンポーネントマップ ビューでエージェントアーキテクチャを探索したり、 コンポーネントグループ ビューで分類されたコンテンツを閲覧したり、1つずつ入力されたコンポーネントグループを展開したり、 RAW モードをオンにしてJSONを検査したり、コンポーネントJSONを調査やサポートのためにコピーしたりできます。

「使用」タブ

使用タブはエージェントの使用記録が存在する場合にのみ表示されます。 次の機能が含まれます。

• 当月累計、直前の2暦月、直近3か月、直近6か月の範囲です。 過去6ヶ月 はデフォルトで選択されます。
• Copilotの総クレジットとアクティブ週あたりの平均クレジット。
• 報告されたユーザーと主要な使用機能。
• 週ごとの信用動向。
• 使用履歴のハイライト、機能別およびチャネル別クレジット、最近の利用記録。
• エージェント固有のExcelエクスポートです。

メタデータタブ

メタデータタブは常に利用可能です。 エージェントIDやスキーマ名、環境IDとURL、場所とソース識別子、診断や統合に使われる生のインベントリフィールドなどの技術的な値を検査するために使います。

在庫データの同期または更新

エージェントインベントリは同期とダッシュボードの更新を分離します。

同期エージェント

テナント在庫を再度回収する必要があるときは、 エージェントを同期 してください。 同期は、 Configure Agent Inventoryに保存されたフィルター、環境グループ、データ収集モード、使用設定、スケジュールに従って行われます。

同期が実行されている間:

• 在庫の状態が 「同期進行中」に変わります。
• 重複操作を防ぐために同期エージェントは無効化されています。
• アクティブな同期設定を変更する設定は利用できません。
• ダッシュボードは同期が落ち着いた後、エージェントの詳細、使用履歴、同期状況、そして最後に同期した情報をリロードします。

ダッシュボードデータを更新

エージェント詳細表とエージェント使用履歴テーブルに既に保存されているデータを再読み込むために「ダッシュボードデータを更新」を選択します。 リフレッシュはエージェント同期を開始せず、環境やエージェントを再発見もしません。 同期が完了した後や、ダッシュボードに古いキャッシュデータが表示されたときに使ってください。

ガバナンス アクション

エージェント・インベントリは再 割り当て、 隔離、 隔離解除 の各アクションをサポートします。 アクションは、選択したすべてのエージェントが対象となる場合にのみ表示されます。

アクションの利用可能性

グリッド内の ステータス 列は、最後の在庫同期時に入力され、Power Platform管理センター(One Inventoryデータ)からの値を反映しています。 どのアクションが表示されるかは、選択したレコードの数とそのステータスによって異なります。

選択されたレコードがある操作と互換性がない場合、その操作はコマンドバーから隠されます。 Power Platform管理センターのコンテキストがインベントリ環境と一致しないレコードには、サポートされていないガバナンスアクションは提供されません。

エージェント詳細ページでは、隔離および解除の可用性は、グリッドに表示される同期状態ではなく、エージェントの稼働状態に基づいています。

再割り当て

一部の組織は、コンプライアンスの目的でエージェントに所有者の存在を求めています。 所有者はエージェントの編集、更新の公開、削除、チームメイトとの共有を許可に基づいて行うことができます。

再割り当て を選択し、Microsoft 365 Copilot ライセンスを持っているユーザーを選択してください。 一括再割り当ての場合、ダイアログに選択された環境、エージェント、現在の所有者、運用状況が表示されます。 再割り当て完了後、処理が成功した各エージェントごとに再割り当ての状態は完了と表示されます。

隔離と解除

隔離は 適格なエージェントをブロックします。 隔離解除 は、対象となるブロックエージェントを復元します。 確認ダイアログでは、操作提出前に影響を受けたエージェント、環境、ステータスを特定します。

一括アクションは1回の作業で最大50人のエージェントをサポートし、選択されたすべてのレコードが対象となる場合にのみ利用可能です。

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

ダッシュボードのヘッダーから 設定 を選択して エージェント同期設定を開きます。 どの環境やエージェントタイプを収集するかを制御したり、在庫オプションを調整したり、同期スケジュールや収集モードを設定したりできます。

環境タイプ

スキャンする環境タイプを選択してください:

• Developer
• Default
• サンドボックス
• 生産
• 試用版
• Teams

環境タイプを選択しない場合、システムにはすべての環境タイプが含まれています。

エージェントの種類

在庫に以下を含めるかどうかを選択してください:

• カスタム エージェント
• 宣言型エージェント

エージェントタイプを選択しない場合、インベントリにはすべてのエージェントタイプが含まれています。

環境グループ

環境グループは再利用可能な同期スコープを提供します。 管理者は次のことが可能です。

• グループを作成して編集します。
• 環境タイプとリージョンフィルターを使ってメンバー環境を選択します。
• グループを有効化または無効化してください。
• もう必要ないグループを削除してください。

グループを有効にしなければ、他の設定で許可されているすべての環境が対象となります。

在庫オプション

同期中にシステムが収集するものを制御するために、以下のオプションを設定してください:

• システムエージェントの除外:同期時にMicrosoft提供のシステムエージェントをスキップします。
• GitHub Copilotエージェント向けにAI生成説明を有効にする:対象となるエージェント詳細ページを訪問した際に説明生成を可能にします。
• 使用量指標を含める:同期時に保持された180日間の使用ウィンドウを収集します。

同期スケジュールと収集モード

同期の実行方法とデータ収集モードを選択してください:

• One Inventory(Power Platform管理センター):管理センターの在庫と環境データを組み合わせ、より広範な発見と豊かなメタデータを実現します。
• 標準(環境のみ):アクセス可能な環境から直接インベントリを取得します。
• 日次自動同期を有効にする:設定済みの日次スケジュールでエージェントインベントリを実行します。

[保存] を選択して変更を適用します。 セーブ は、設定が変更されていない場合、セーブ進行中、またはアクティブな同期中に設定が利用できない場合に無効になります。

データ収集モード

データ収集モードの設定は、システムがどのようにエージェントレコードを検出・収集するかを決定します。

One Inventory モード（推奨）

収集モードを One Inventoryに設定すると、エージェント・インベントリはOne Inventoryのデータを使用します:

1. One InventoryからPower Platform管理センターを通じてエージェントデータを取得します。
2. 環境はCopilot Agent Kit - Power Platform for Admins V2の接続参照を使ってリストアップされています。
3. One Inventoryエージェントのデータと環境リストを組み合わせて環境詳細を構築します。
4. 各環境ごとに、環境から取得したエージェントと対応するOne Inventoryデータを統合することでエージェントの詳細をエージェントインベントリに読み込みます。

より広範なテナント探索やより豊かなPower Platform管理センターメタデータが必要な場合にこのモードを活用してください。 管理センターで検出されたものの、その環境ではアクセスできないエージェントも、限られた詳細情報と共に追加されます。

標準モード

収集モードを 標準に設定すると、エージェント・インベントリは標準のデータ収集方式を使用します。

1. Copilot Agent Kit - Power Platform for Admins connection reference(V1)を使ってすべての環境を一覧化しています。
2. 各環境ごとにエージェントを取得します。
3. エージェントデータをエージェントインベントリに読み込みます。

コレクションをアクセシブルな環境だけに頼りたいときは、このモードを使いましょう。

両モードともに、エージェントインベントリはCopilot Agent Kit - Dataverse接続参照を用いて各環境に接続し、メタデータ、機能使用状況、設定などの詳細なエージェント情報を収集します。 システムは、設定されたアカウントがシステム管理者権限を持つ環境でのみ詳細な情報を取得します。

キット全体で使用されるコネクタの全リストについては 「コネクタ要件」をご覧ください。

使用状況メトリック

エージェント・インベントリは最大180日分のエージェント使用データを保持・表示できます。 使用分析を有効にするには:

1. 必要なソリューション接続がデータポリシーによって設定され許可されていることを確認してください。
2. オープン エージェント同期設定。
3. 使用指標を含めることを有効にしてください。
4. 保存を選びます。
5. エージェントの 同期を選択するか、日々の自動同期を待ってください。

使用データは エージェント詳細 表と エージェント使用履歴 表に格納されます。 エージェントの 使用 タブは、使用履歴の記録が一致している場合にのみ表示されます。

Microsoft Entra ID接続でHTTPを設定してください

使用状況の指標は、Microsoft Entra ID(事前承認済み)コネクタを使ったHTTPに依存しています。 接続値はテナントが使っているクラウドによって異なります。 接続を作成する際は、クラウドに合ったBase Resource URLとMicrosoft Entra ID Resource URIを使ってください。

許可およびコネクターの要件

ソリューション内の接続参照の 制限 と、エージェントへの可視性の 制御 。 テナント全体の完全な可視性を得るために、 Power Platform管理者 の役割を持つアカウントで接続参照を設定してください。 すべての機能レベルの詳細を取得するには、そのアカウントが関連環境に対してシステム 管理者 のアクセス権も必要です。 他のアカウントを使用できますが、エージェント インベントリの可視性は、ユーザーがシステム管理者アクセス権を持つ環境に限定されます。

エージェントインベントリは、環境に適用されるデータポリシーが許可する以下のコネクタに依存しています。

• マイクロソフト Dataverse
• 管理者向けPower Platform
• Power Platform 管理者向け V2
• HTTP と Microsoft Entra ID（事前認証済み）

キット全体で使用されるコネクタの全リストについては 「コネクタ要件」をご覧ください。

以下のDataverseテーブルはエージェントインベントリデータを格納しています:

次のステップ

関連情報

• エージェント インベントリのデータ ソース
• エージェントインベントリ接続参照の設定
• コネクタ要件