本文介绍 Power Platform 清单中与 Copilot Studio 代理（microsoft.copilotstudio/agents）相关的特定字段。 有关所有资源类型可用的共享字段，请参阅 Power Platform 清单架构参考。 有关清单功能的概述，请参阅 Power Platform 清单。
核心属性
| API 字段路径 | 数据类型 | Description | 示例 | 地位 |
|---|---|---|---|---|
properties.ownerId |
字符串 | 资源所有者的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.environmentId |
字符串 | 包含资源的环境的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastPublishedAt |
日期/时间 | 智能体上次发布的日期和时间。 如果智能体仍处于草稿状态，则为空。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.createdIn |
字符串 | 创建智能体的编写工具：Copilot Studio 或智能 Microsoft 365 Copilot 副驾驶® Agent Builder。 | Copilot Studio |
普遍可用 |
properties.schemaName |
字符串 | Dataverse 架构名称。 适用于 Copilot Studio 代理和 Microsoft 365 Copilot 代理生成器代理。 | cr5e3_agentName |
普遍可用 |
properties.isQuarantined |
boolean | 代理是否被隔离。 | false |
预览 |
properties.quarantinedAt |
日期/时间 | 代理上次隔离的日期和时间。 | 2026-02-01T08:00:00Z |
预览 |
properties.isManaged |
boolean | 代理是否是托管解决方案的一部分。 | false |
预览 |
身份属性
| API 字段路径 | 数据类型 | Description | 示例 | 地位 | 适用于 |
|---|---|---|---|---|---|
properties.botId |
字符串 | 环境中的 CDS 机器人 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 | Copilot Studio 代理，Microsoft 365 Copilot 代理生成器代理 |
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代理 |
注释
该 entraAppId 字段是旧标识符。 较新的代理使用entraAgentId和entraAgentBlueprintId。 这些标识属性都不适用于 Microsoft 365 Copilot 代理生成器代理。
配置属性
| API 字段路径 | 数据类型 | Description | 示例 | 地位 |
|---|---|---|---|---|
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）智能体。
- 标识属性可能不适用于所有代理。 仅对于使用较新 Entra 代理标识模型预配的代理，才会填充
entraAgentId和entraAgentBlueprintId字段。 旧代理可能仅具有entraAppId，Microsoft 365 Copilot 代理生成器代理没有任何这些标识属性。