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 インベントリスキーマリファレンス」を参照してください。

Note

インベントリには、V1 のCopilot Studio (クラシックボットまたは Power Virtual Agents とも呼ばれます) で作成されたエージェントは含まれません。ただし、引き続き Power Platform 管理センターに移動し、Manage>Copilot Studio>Classic chatbots を選択して、それらのエージェントを表示できます。

Important

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

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

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

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

インベントリには、エージェントごとに次のプロパティが用意されています。

Note

インベントリには、各エージェントの 公開バージョン の構造が反映されます。エージェントに未公開の変更（新しいドラフト）がある場合、その変更はエージェントが公開されるまでインベントリに表示されません。
エージェントの構成によって、どのフィールドに値が設定されるかが決まります。エージェントの設定方法によっては、一部のプロパティが null される場合があります。たとえば、Agent Builder で作成されたエージェントでは、isManaged は null です。

コアプロパティ

API フィールドパス	データの種類	Description	例	Status
`properties.displayName`	文字列	エージェントの表示名。	`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`	文字列	エージェントの現在の所有者のオブジェクト ID（Entra ID）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般公開
`properties.environmentId`	文字列	リソースを含む Power Platform 環境の識別子。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般公開
`properties.lastPublishedAt`	datetime	エージェントが最後に発行された日時。エージェントがまだドラフト内にある場合は空/null。	`2026-01-15T10:30:00Z`	一般公開
`properties.createdIn`	文字列	エージェントが作成されたオーサリングツール: Copilot Studio または Microsoft 365 Copilot Agent Builder。	`Copilot Studio`	一般公開
`properties.schemaName`	文字列	Dataverse スキーマ名。 Copilot Studio エージェントと Microsoft 365 Copilot Agent Builder エージェントで使用できます。	`cr5e3_agentName`	一般公開
`properties.isQuarantined`	boolean	エージェントが現在検疫されているかどうか。	`false`	Preview
`properties.quarantinedAt`	datetime	エージェントが最後に検疫された日時。	`2026-02-01T08:00:00Z`	Preview
`properties.isManaged`	boolean	エージェントがマネージド Dataverse ソリューションの一部であるかどうか。エージェントビルダーで作成されたエージェントの場合は Null。	`false`	Preview

Entra identity のプロパティ

API フィールドパス	データの種類	Description	例	Status
`properties.botId`	文字列	環境内の CDS ボット ID。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般公開
`properties.entraAppId`	文字列	エージェントに関連付けられている Entra アプリ登録 ID (存在する場合)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般公開
`properties.entraAgentId`	文字列	Entra エージェント ID (存在する場合)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般公開
`properties.entraAgentBlueprintId`	文字列	Entra Agent Blueprint ID (存在する場合)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	一般公開

Note

すべての種類のエージェントですべての ID プロパティを使用できるわけではありません。 entraAppId はレガシ識別子であり、新しいエージェントは entraAgentId と entraAgentBlueprintIdを使用します。これらのフィールドは、特定のエージェントに適用できる場合にのみ設定されます。これらの ID プロパティは、Microsoft 365 Copilot Agent Builder エージェントには適用されません。

Entra ID の概念の詳細については、「App の登録、エージェント ID、および Copilot Studioを参照してください。

設定プロパティ

API フィールドパス	データの種類	Description	例	Status
`properties.orchestration`	文字列	エージェントのオーケストレーションモード ( オーケストレーションモードの詳細を参照)。	`Generative`	Preview
`properties.model`	文字列	エージェントによって使用される AI モデル。	`gpt-4o`	Preview
`properties.authentication`	文字列	エージェント用に構成された認証モード ( 認証モードの詳細を参照)。	`Microsoft Entra`	Preview
`properties.channels`	アレイ	エージェントが公開されているチャンネルの表示名。	`["Teams","SharePoint"]`	Preview
`properties.sharedWithViewers`	オブジェクト	エージェントが共有されている個々のビューアーユーザー (`userCount`) とビューアーグループ (`groupCount`) の数。作成者がエージェントをテナント全体と共有した場合、管理者が共有を承認しなかった場合でも、 `entireTenant` は `true` に設定されます。	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Preview
`properties.sharedWithEditors`	オブジェクト	エージェントが共有されている個々のエディターユーザー (`userCount`) とエディターグループ (`groupCount`) の数。	`"groupCount": 0, "userCount": 0`	Preview
`properties.capabilitiesCounts`	オブジェクト	構成された機能の種類ごとの個別の合計数	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Preview

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

properties.orchestration フィールドには、次の値を指定できます。

価値	Description
Classic	エージェントは、作成されたダイアログツリーを含むクラシックトピックベースのオーケストレーションを使用します。
生成	エージェントは生成オーケストレーションを使用します。AI モデルはトピックとアクションを動的に選択します。

認証モード

properties.authentication フィールドには、次の値を指定できます。

価値	Description
None	認証は必要ありません。
Microsoft Entra	Microsoft Entra ID を使用した認証。
汎用 OAuth 2.0	汎用 OAuth 2.0 プロバイダーによる認証。

エージェント機能

このセクションでは、エージェントの機能 (ツールと知識) の一覧を示します。現時点では、次のセクションで詳しく説明するように、エージェントによって使用されるコネクタとナレッジ構成に関する詳細なデータのみが表示されます。

インベントリには、エージェントごとに各種類の最大 200 個のリソースの制限があります。詳細については、「既知の制限事項」を参照してください。

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

コネクタのプロパティ

インベントリには、エージェントで構成された Power Platform コネクタを含む powerPlatformConnectors と呼ばれる配列が含まれています。各コネクタは、その connectorId (コネクタのリソース ID を含む文字列、たとえば、 shared_excelonlinebusiness) によって識別されます。構成されたコネクタごとに、構成された operationsの一覧が表示されます。この一覧には、次のプロパティが含まれています。

Property	データの種類	Description	Status
`OperationId`	文字列	コネクタ内の特定の操作の ID。例えば `AddRowV2`	Preview
`createdBy`	GUID	操作を構成したユーザー	Preview
`isEnabled`	boolean	コネクタ操作が現在有効になっているかどうか	Preview
`usedAs`	文字列	操作の使用方法: `Tool` 一般的なツールとして構成されている場合 `Topic Tool` 特定のトピックでツールとして構成されている場合 `Knowledge` コネクタがナレッジソースとして構成されている場合	Preview
`requiresEndUserConsent`	boolean	エージェントが操作を使用する前にエンドユーザーが同意する必要があるかどうか	Preview
`whenCanBeUsed`	文字列	操作を呼び出すことができる場合: `Anytime` 制限なしでエージェントがツールを使用できる場合 `ViaDirectReferenceOnly` 特定のトピックで作成者がツールを明示的に構成した場合にのみエージェントがツールを使用する場合 `Conditional` エージェントが作成者によって定義済みのロジックに従ってツールを使用できる場合	Preview
`connectionProvider`	文字列	その操作用の接続を提供するのは誰ですか: `User` エンドユーザーが実行時に資格情報を提供する場合 `Maker` 作成者が作成時に接続を設定する場合	Preview
`connectionIdSharedByMaker`	GUID	接続ID（`connectionProvider = Maker` の場合のみ設定）	Preview

例

{
  "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
    }
  }
}

知識の属性

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

Property	データの種類	Description	Status
`IsWebSearchEnabledForKnowledge`	boolean	True の場合、エージェントは、ナレッジソースとして Web 検索を使用できます。	Preview

既知の制限

V1 エージェントは追跡されません - インベントリには、元の Power Virtual Agents V1 ランタイムで作成されたエージェントは含まれません。 V2 (Copilot Studio) エージェントのみを追跡します。
ID プロパティは、すべてのエージェントで使用できるわけではありません 。 entraAgentId フィールドと entraAgentBlueprintId フィールドは、新しい Entra エージェント ID モデルでプロビジョニングされたエージェントに対してのみ設定されます。古いエージェントには entraAppIdのみが含まれる場合があり、Microsoft 365 Copilot エージェントビルダーエージェントにはこれらの ID プロパティがありません。
機能の数 - インベントリには、エージェントごとに各種類の最大 200 個のリソースの制限があります。エージェントに特定の種類 (Power Platform コネクタなど) から構成されたリソースが 200 を超える場合、インベントリにはランダムな 200 が表示されます。管理者は、 capabilitiesCounts フィールドを使用して、種類ごとにエージェントで構成されているリソースの数を把握できます。

フィードバック

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

Last updated on 2026-06-04

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

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

コア プロパティ

Entra identity のプロパティ

設定プロパティ

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

認証モード

エージェント機能

コネクタのプロパティ

例

知識の属性

既知の制限

関連するコンテンツ

フィードバック

その他のリソース

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

コアプロパティ

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