Microsoft Copilot Studio エージェントインベントリ

Copilot Studio エージェントインベントリは、IT およびセキュリティ管理者に、テナント内で Copilot Studio またはエージェントビルダーを使用して作成されたすべてのエージェントの集中表示を提供します。インベントリには、未公開（ドラフト）および公開済みのエージェントの両方が含まれます。インベントリには、各エージェントの作成者、最終公開日時、展開先チャネル、ユーザー認証方法、機能などの主要なメタデータが表示されます。インベントリデータは自動的に更新され、エージェントの変更は通常20分以内に反映されます。

管理者は、Power Platform の管理センター、Power Platform API、Azure Resource Graph など、複数の方法でインベントリデータを利用できます。アクセス方法および必要なロールの一覧については、Power Platform インベントリをご参照ください。

この記事では、Power Platform インベントリ内の Copilot Studio エージェント（microsoft.copilotstudio/agents）に固有のフィールドについて説明します。すべてのリソースタイプで利用できる共通フィールドについては、Power Platform インベントリスキーマ参照をご参照ください。

紙幣

本インベントリには、Copilot Studio の V1（クラシックボットや Power Virtual Agents とも呼ばれる）で作成されたエージェントは含まれていません。ただし、Power Platform 管理センターに移動し、管理>Copilot Studio>Classic チャットボットを選択すると、これらのエージェントを表示できます。

重要

この記事には Microsoft Copilot Studio プレビュードキュメントが含まれ、変更される可能性があります。

プレビュー機能は運用環境での使用を想定しておらず、機能が制限される可能性があります。これらの機能は公式リリースの前に使用できるため、一足先にアクセスしてフィードバックを送ることができます。

運用に対応したエージェントを構築する場合は Microsoft Copilot Studio の概要を参照してください。

エージェントのプロパティ

インベントリは各エージェントごとに以下のプロパティを提供します。

紙幣

インベントリは各エージェントの 公開版 の構成を反映しています。エージェントに未公開の変更（新しいドラフト）がある場合、その変更はエージェントが公開されるまでインベントリに表示されません。
エージェントの構成によって、どのフィールドにデータが入力されるかが決まります。エージェントの設定によっては、プロパティが null になる場合もあります。例えば、エージェントビルダーで作成されたエージェントの場合、isManagedはnullになります。

コアプロパティ

API フィールドパス	データ型	説明	例	ステータス
`properties.displayName`	string	エージェントの表示名。	`Customer support agent`	一般に入手可能
`properties.name`	GUID	特定のDataverse環境におけるエージェントのID（CDSボットID）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般に入手可能
`properties.createdAt`	datetime	エージェントが作成された日時。	`2024-12-13T04:00:00Z`	一般に入手可能
`properties.createdBy`	GUID	エージェントを作成したユーザーを表す Entra ID です。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般に入手可能
`properties.ownerId`	string	エージェントの現在の所有者のオブジェクトID（Entra ID）	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般に入手可能
`properties.environmentId`	string	リソースを含む Power Platform 環境の識別子。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般に入手可能
`properties.lastPublishedAt`	datetime	エージェントを最後に公開した日時。エージェントがドラフト中の場合は空/null です。	`2026-01-15T10:30:00Z`	一般に入手可能
`properties.createdIn`	string	エージェントを作成したオーサリングツール：Copilot Studio または Microsoft 365 Copilot エージェントビルダー。	`Copilot Studio`	一般に入手可能
`properties.schemaName`	string	Dataverseスキーマ名。 Copilot Studio エージェントおよび Microsoft 365 Copilot エージェントビルダーエージェントで利用可能です。	`cr5e3_agentName`	一般に入手可能
`properties.isQuarantined`	boolean	エージェントが現在隔離されているかどうか。	`false`	プレビュー
`properties.quarantinedAt`	datetime	エージェントを最後に隔離した日時。	`2026-02-01T08:00:00Z`	プレビュー
`properties.isManaged`	boolean	エージェントがマネージド Dataverse ソリューションの一部であるかどうか。エージェントビルダーで作成されたエージェントの場合、nullとなります。	`false`	プレビュー

Entra ID のプロパティ

API フィールドパス	データ型	説明	例	ステータス
`properties.botId`	string	環境内の CDS ボット ID。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般に入手可能
`properties.entraAppId`	string	エージェントに関連付けられたEntraアプリ登録ID（存在する場合）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般に入手可能
`properties.entraAgentId`	string	EntraエージェントのアイデンティティID（存在する場合）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般に入手可能
`properties.entraAgentBlueprintId`	string	EntraエージェントブループリントID（存在する場合）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般に入手可能

紙幣

すべてのエージェントタイプで全ての識別プロパティが利用できるとは限りません。entraAppId はレガシー識別子であり、新しいエージェントでは entraAgentId および entraAgentBlueprintId が使用されます。これらのフィールドは、特定のエージェントに該当する場合のみ設定されます。これらのアイデンティティプロパティはMicrosoft 365 Copilot エージェントビルダーエージェントには適用されません。

Entra IDのアイデンティティに関する詳細については、Copilot Studio のアプリ登録、エージェントのアイデンティティ、および認証をご覧ください。

構成プロパティ

API フィールドパス	データ型	説明	例	ステータス
`properties.orchestration`	string	エージェントのオーケストレーションモード（詳細は「オーケストレーションモード」をご覧ください）。	`Generative`	プレビュー
`properties.model`	string	エージェントが使用するAIモデル。	`gpt-4o`	プレビュー
`properties.authentication`	string	エージェントに設定された認証モード（詳細は認証モードをご覧ください）。	`Microsoft Entra`	プレビュー
`properties.channels`	配列	エージェントが公開されているチャンネルの表示名。	`["Teams","SharePoint"]`	プレビュー
`properties.sharedWithViewers`	オブジェクト	エージェントが共有されている個別のビューアーユーザー（`userCount`）およびビューアーグループ（`groupCount`）の数。作成者がエージェントをテナント全体と共有した場合、管理者が共有を承認していなくても、`entireTenant` は `true` に設定されます。	`"groupCount": 0, "userCount": 0, "entireTenant": false`	プレビュー
`properties.sharedWithEditors`	オブジェクト	エージェントが共有されている個々の編集者ユーザー数（`userCount`）および編集者グループ数（`groupCount`）。	`"groupCount": 0, "userCount": 0`	プレビュー
`properties.capabilitiesCounts`	オブジェクト	設定された機能の各タイプの合計一意数	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	プレビュー

オーケストレーションモード

properties.orchestration フィールドは次の値を受け取ります。

金額	内容
クラシック	エージェントは、作成されたダイアログツリーを用いたクラシックなトピックベースのオーケストレーションを使用します。
生成型	エージェントは生成オーケストレーションを用いており、AIモデルがトピックやアクションを動的に選択します。

認証モード

properties.authentication フィールドは次の値を受け取ります。

金額	説明
なし	認証は不要です。
Microsoft Entra	Microsoft Entra ID を使用した認証。
汎用 OAuth 2.0	汎用OAuth 2.0 プロバイダーによる認証。

エージェント機能

このセクションでは、エージェントの機能（ツールおよび知識）を一覧表示します。現在、エージェントが使用するコネクタの詳細データと、以下のセクションで詳述するナレッジ構成のみを表示します。

インベントリには、各エージェントごとに各タイプにつき最大200件のリソース制限があります。詳細については、既知の制約を参照してください。

インベントリは、同じ構成で1つのエージェント内に2回設定されたPower Platform コネクタなど、重複するリソースを自動的に削除します。

コネクタプロパティ

インベントリには、エージェントで構成されたPower Platformコネクタが格納されている powerPlatformConnectors という配列が含まれています。各コネクタは、その connectorId（コネクタのリソース ID を含む文字列。例：shared_excelonlinebusiness）によって識別されます。構成済みのコネクタごとに、構成済みの operations のリストがあります。リストには、次のプロパティが含まれています。

プロパティ	データ型	説明	ステータス
`OperationId`	string	コネクタ内の特定の操作の ID（例：`AddRowV2`）	プレビュー
`createdBy`	GUID	当該操作を構成したユーザー	プレビュー
`isEnabled`	boolean	コネクタ操作が現在有効かどうか	プレビュー
`usedAs`	string	操作の使い方: `Tool`: 一般的なツールとして設定された場合 `Topic Tool`: 特定のトピックのツールとして設定された場合 `Knowledge`: コネクターがサポート情報ソースとして構成されている場合	プレビュー
`requiresEndUserConsent`	boolean	エージェントが操作を利用する際にエンドユーザーの同意が必要かどうか	プレビュー
`whenCanBeUsed`	string	操作を実行できるタイミング: `Anytime`: エージェントが制限なくツールを利用できる場合 `ViaDirectReferenceOnly`: エージェントがツールを使用する場合 (メーカーが特定のトピックで明示的に構成した場合のみ) `Conditional`: エージェントがメーカーによって定義されたロジックに従ってツールを使用できる場合	プレビュー
`connectionProvider`	string	操作に必要な接続を提供するのは誰か: `User`: エンドユーザーが実行時に認証情報を提供した場合 `Maker`: 作成者がオーサリング時に接続を設定した場合	プレビュー
`connectionIdSharedByMaker`	GUID	接続ID（`connectionProvider = Maker` の場合のみ設定されます）	プレビュー

例

{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

ナレッジプロパティ

このインベントリには、以下のナレッジに関する項目が含まれています:

プロパティ	データ型	説明	ステータス
`IsWebSearchEnabledForKnowledge`	boolean	エージェントがウェブ検索をサポート情報ソースとして利用可能な場合は「true」	プレビュー

既知の制限

V1 エージェントは追跡されません - インベントリには、元のPower Virtual Agents V1 ランタイムで作成されたエージェントは含まれていません。 V2（Copilot Studio）のエージェントのみを追跡しています。
すべてのエージェントでアイデンティティプロパティが利用できるとは限りません - entraAgentId および entraAgentBlueprintId フィールドは、新しい Entra エージェントアイデンティティモデルでプロビジョニングされたエージェントのみ設定されます。古いエージェントはentraAppIdのみ保持している場合があり、Microsoft 365 Copilot エージェントビルダーエージェントにはこれらのアイデンティティプロパティがありません。
キャパビリティ数 - インベントリには各エージェントの各タイプごとに最大200リソースの制限があります。エージェントに特定の種類の構成済みリソース（例：Power Platform コネクタ）が200を超えている場合、インベントリにはランダムに選ばれた200件が表示されます。管理者は capabilitiesCounts フィールドを使用して、各リソースタイプごとにエージェントに設定されているリソース数を確認できます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-07-30

Microsoft Copilot Studio エージェント インベントリ

エージェントのプロパティ

コア プロパティ

Entra ID のプロパティ

構成プロパティ

オーケストレーション モード

認証モード

エージェント機能

コネクタ プロパティ

例

ナレッジ プロパティ