この記事では、Power Platform インベントリの Copilot Studio エージェント (microsoft.copilotstudio/agents) に固有のフィールドについて説明します。 すべてのリソースの種類で使用できる共有フィールドについては、「 Power Platform インベントリ スキーマ リファレンス」を参照してください。 インベントリ機能の概要については、「 Power Platform インベントリ」を参照してください。
コア プロパティ
| API フィールド パス | データの種類 | Description | Example | 地位 |
|---|---|---|---|---|
properties.ownerId |
文字列 | リソース所有者のオブジェクト ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
一般公開 |
properties.environmentId |
文字列 | リソースを含む環境の識別子。 | aaaa0000-bb11-2222-33cc-444444dddddd |
一般公開 |
properties.lastPublishedAt |
datetime | エージェントが最後に発行された日時。 エージェントがまだ下書き状態の場合は空欄です。 | 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 |
プレビュー |
properties.quarantinedAt |
datetime | エージェントが最後に検疫された日時。 | 2026-02-01T08:00:00Z |
プレビュー |
properties.isManaged |
boolean | エージェントがマネージド ソリューションの一部であるかどうか。 | false |
プレビュー |
アイデンティティ プロパティ
| API フィールド パス | データの種類 | Description | Example | 地位 | 使用可能な対象 |
|---|---|---|---|---|---|
properties.botId |
文字列 | 環境内の CDS ボット ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
一般公開 | Copilot Studio エージェント、Microsoft 365 Copilot Agent Builder エージェント |
properties.entraAppId |
文字列 | Entra アプリ登録 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
一般公開 | Copilot Studio エージェント |
properties.entraAgentId |
文字列 | Entra エージェント アイデンティティ ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
一般公開 | Copilot Studio エージェント |
properties.entraAgentBlueprintId |
文字列 | Entra エージェントのブループリント ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
一般公開 | Copilot Studio エージェント |
Note
entraAppId フィールドはレガシ識別子です。 新しいエージェントでは、代わりに entraAgentId と entraAgentBlueprintId が使用されます。 これらの ID プロパティは、Microsoft 365 Copilot Agent Builder エージェントには適用されません。
設定プロパティ
| API フィールド パス | データの種類 | Description | Example | 地位 |
|---|---|---|---|---|
properties.orchestration |
文字列 | エージェントのオーケストレーション モード ( オーケストレーション モードを参照)。 | Generative |
プレビュー |
properties.model |
文字列 | エージェントによって使用される AI モデル。 | gpt-4o |
プレビュー |
properties.authentication |
文字列 | エージェント用に構成された認証モード ( 認証モードを参照)。 | Microsoft Entra |
プレビュー |
properties.channels |
アレイ | エージェントが公開されているチャネルの表示名。 | ["Teams","SharePoint"] |
プレビュー |
オーケストレーション モード
properties.orchestration フィールドには、次の値を指定できます。
| 価値 | Description |
|---|---|
Classic |
エージェントは、作成されたダイアログ ツリーを含むクラシック トピック ベースのオーケストレーションを使用します。 |
Generative |
エージェントは生成オーケストレーションを使用します。AI モデルはトピックとアクションを動的に選択します。 |
認証モード
properties.authentication フィールドには、次の値を指定できます。
| 価値 | Description |
|---|---|
None |
認証は必要ありません。 |
Microsoft Entra |
Microsoft Entra ID を使用した認証。 |
Generic OAuth 2.0 |
汎用 OAuth 2.0 プロバイダーによる認証。 |
既知の制限
- V1 エージェントは追跡されません。 元の Power Virtual Agents V1 ランタイムで作成されたエージェントは、インベントリに含まれません。 追跡されるのは V2 (Copilot Studio) エージェントのみです。
- ID プロパティは、すべてのエージェントで使用できるわけではありません。
entraAgentIdフィールドとentraAgentBlueprintIdフィールドは、新しい Entra エージェント ID モデルでプロビジョニングされたエージェントに対してのみ設定されます。 古いエージェントにはentraAppIdのみが含まれる場合があり、Microsoft 365 Copilot Agent Builder エージェントにはこれらの ID プロパティはありません。