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 清单架构参考。
注释
清单不包括使用 V1 Copilot Studio（也称为经典机器人或 Power Virtual Agent）创建的代理。 但是，仍可以转到 Power Platform 管理中心，然后选择 Manage>Copilot Studio>Classic chatbots查看这些代理。
Important
本文包含 Microsoft Copilot Studio 预览版文档，有可能会有变动。
预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前可用，以便你可以提前访问并提供 反馈。
如果您在构建可投入生产的代理，请参阅 Microsoft Copilot Studio 概述。
代理属性
清单为每个代理提供以下属性。
注释
清单反映每个代理 的已发布版本 的结构。 如果代理存在尚未发布的更改（较新的草稿版本），则在该代理发布之前，清单不会显示这些更改。
代理配置会影响哪些字段会被填充。 某些属性可能
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 |
日期/时间 | 创建代理的日期和时间。 | 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 |
日期/时间 | 代理上次发布的日期和时间。 如果代理仍在草稿中，则为空/null。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.createdIn |
字符串 | 在其中创建了代理的创作工具：Copilot Studio 或 智能 Microsoft 365 Copilot 副驾驶® 代理生成器。 | Copilot Studio |
普遍可用 |
properties.schemaName |
字符串 | Dataverse 架构名称。 适用于 Copilot Studio 代理和 智能 Microsoft 365 Copilot 副驾驶® 代理生成器代理。 | cr5e3_agentName |
普遍可用 |
properties.isQuarantined |
布尔 | 代理当前是否处于隔离状态。 | false |
预览版 |
properties.quarantinedAt |
日期/时间 | 代理上次隔离的日期和时间。 | 2026-02-01T08:00:00Z |
预览版 |
properties.isManaged |
布尔 | 代理是否属于托管的 Dataverse 解决方案。 对于在代理生成器中创建的代理，该值为 Null。 | false |
预览版 |
Entra 标识属性
| API 字段路径 | 数据类型 | Description | 示例 | Status |
|---|---|---|---|---|
properties.botId |
字符串 | 环境中的 CDS 机器人 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.entraAppId |
字符串 | 与代理关联的 Entra 应用注册 ID（如果存在）。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.entraAgentId |
字符串 | Entra Agent Identity ID（如果存在）。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.entraAgentBlueprintId |
字符串 | Entra 代理蓝图 ID（如果有）。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
注释
并非所有标识属性都可用于所有代理类型： entraAppId 是旧标识符、较新的代理使用 entraAgentId 和 entraAgentBlueprintId。 仅当适用于特定代理时，才会填充这些字段。 这些标识属性都不适用于 智能 Microsoft 365 Copilot 副驾驶® 代理生成器代理。
若要了解有关 Entra 标识概念的详细信息，请参阅
配置属性
| API 字段路径 | 数据类型 | Description | 示例 | Status |
|---|---|---|---|---|
properties.orchestration |
字符串 | 代理的编排模式（在 编排模式中了解更多）。 | Generative |
预览版 |
properties.model |
字符串 | 代理使用的 AI 模型。 | gpt-4o |
预览版 |
properties.authentication |
字符串 | 为代理配置的身份验证模式（在 身份验证模式下了解详细信息）。 | 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 字段接受以下值：
| 价值 | Description |
|---|---|
| Classic | 代理使用经典主题的编排与设计的对话树相结合。 |
| 生成式 | 代理使用生成式编排，其中 AI 模型动态选择主题和操作。 |
身份验证模式
该 properties.authentication 字段接受以下值：
| 价值 | Description |
|---|---|
| None | 无需身份验证。 |
| Microsoft Entra | 通过 Microsoft Entra ID 进行身份验证。 |
| 通用 OAuth 2.0 | 通过通用 OAuth 2.0 提供程序进行身份验证。 |
代理功能
本部分列出了代理的功能（工具和知识）。 目前，它仅显示代理使用的连接器的详细数据，以及以下各节中详述的知识配置。
每个代理的库存中，每种类型的资源最多为 200 个。 在 已知限制中了解详细信息。
清单会自动删除重复的资源，例如在具有相同配置的代理中配置的两次 Power Platform 连接器。
连接器属性
该清单包含一个名为 powerPlatformConnectors 的数组，其中包含在代理中配置的 Power Platform 连接器。 每个连接器由其connectorId标识（包含连接器的资源 ID 的字符串）;例如。 shared_excelonlinebusiness 对于每个配置的连接器，都有一个已配置 operations的列表。 该列表包含以下属性：
| 财产 | 数据类型 | Description | Status |
|---|---|---|---|
OperationId |
字符串 | 连接器中特定操作的 ID;例如， AddRowV2 |
预览版 |
createdBy |
GUID | 配置操作的用户 | 预览版 |
isEnabled |
布尔 | 连接器操作当前是否已启用 | 预览版 |
usedAs |
字符串 | 该操作的使用方式：
|
预览版 |
requiresEndUserConsent |
布尔 | 最终用户是否必须同意，然后代理才能使用该操作 | 预览版 |
whenCanBeUsed |
字符串 | 何时可调用该操作：
|
预览版 |
connectionProvider |
字符串 | 为操作提供连接的人员：
|
预览版 |
connectionIdSharedByMaker |
GUID | 连接 ID，仅当 connectionProvider = Maker 时才会填充 |
预览版 |
知识属性
清单包括以下知识属性：
| 财产 | 数据类型 | Description | Status |
|---|---|---|---|
IsWebSearchEnabledForKnowledge |
布尔 | 如此 如果代理可以使用 Web 搜索作为知识源 | 预览版 |
已知的限制
- 不会跟踪 V1 代理 - 清单不包括使用原始 Power Virtual Agents V1 运行时创建的代理。 它仅跟踪 V2 （Copilot Studio） 代理。
-
标识属性可能并非对所有代理都可用 - 仅为使用较新的 Entra 代理标识模型预配的代理填充
entraAgentId和entraAgentBlueprintId字段。 较旧的代理可能只有entraAppId，智能 Microsoft 365 Copilot 副驾驶®代理生成器代理没有任何这些标识属性。 -
能力数量 - 每个代理的资源清单中，每种类型的资源最多只能有 200 个。 如果代理具有特定类型（例如 Power Platform 连接器）中配置的 200 多个资源，则清单将显示随机 200。 管理员可以使用该
capabilitiesCounts字段了解每个类型代理中配置的资源数。