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>经典聊天机器人以查看这些智能体。

重要提示

本文包含 Microsoft Copilot Studio 预览版文档，有可能会有变动。

预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前已经可用，以便您可以及早使用并提供反馈。

如果您在构建生产就绪型智能体，请参阅 Microsoft Copilot Studio 概述。

智能体属性

库存为每个智能体提供以下属性。

备注

  • 库存反映每个智能体的已发布版本的结构。 如果智能体有未发布的更改（较新的草稿），在智能体发布之前，库存不会显示这些更改。

  • 智能体的配置会影响填充哪些字段。 根据智能体的设置，某些属性可能是 null。 例如，对于在智能体生成器中创建的智能体，isManaged 为 null。

核心属性

API 字段路径 数据类型 说明 示例 执行状态
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 副驾驶® 副驾驶® 智能体生成器智能体。 cr5e3_agentName 正式发布
properties.isQuarantined boolean 该智能体当前是否已隔离。 false 预览版
properties.quarantinedAt datetime 智能体上次隔离的日期和时间。 2026-02-01T08:00:00Z 预览版
properties.isManaged boolean 智能体是否为托管 Dataverse 解决方案的一部分。 对于在智能体生成器中创建的智能体，为 null。 false 预览版

Entra 标识属性

API 字段路径 数据类型 说明 示例 执行状态
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 智能体蓝图 ID（如果有）。 aaaa0000-bb11-2222-33cc-444444dddddd 正式发布

备注

并非所有标识属性都适用于所有智能体类型：entraAppId 是旧的标识符，较新的智能体使用 entraAgentId 和 entraAgentBlueprintId。 这些字段仅在适用于特定智能体时才填充。 这些标识属性均不适用于智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 智能体生成器智能体。

若要了解有关 Entra 标识概念的详细信息，请参阅 Copilot Studio 的应用注册、智能体标识和身份验证。

配置属性

API 字段路径 数据类型 说明 示例 执行状态
properties.orchestration 字符串 智能体的编排模式（在编排模式中了解详细信息）。 Generative 预览版
properties.model 字符串 智能体使用的 AI 模型。 gpt-4o 预览版
properties.authentication 字符串 为智能体配置的身份验证模式（在身份验证模式中了解详细信息）。 Microsoft Entra 预览版
properties.channels array 智能体发布到的频道的显示名称。 ["Teams","SharePoint"] 预览版
properties.sharedWithViewers object 与智能体共享的各个查看器用户 (userCount) 和查看器组 (groupCount) 的计数。 如果制作者与整个租户共享了智能体，即使管理员未批准共享，entireTenant 也会设置为 true。 "groupCount": 0, "userCount": 0, "entireTenant": false 预览版
properties.sharedWithEditors object 与智能体共享的各个编辑器用户 (userCount) 和编辑器组 (groupCount) 的计数。 "groupCount": 0, "userCount": 0 预览版
properties.capabilitiesCounts object 每种配置功能类型的非重复计数总计 "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 预览版

业务流程模式

properties.orchestration 字段接受以下值：

值 描述
经典 该智能体使用基于主题的经典编排，并包含编写的对话树。
生成式 智能体使用生成式编排，其中 AI 模型会动态选择主题和操作。

身份验证模式

properties.authentication 字段接受以下值：

值 说明
无​ 不要求进行身份验证。
Microsoft Entra 通过 Microsoft Entra ID 进行身份验证。
通用 OAuth 2.0 通过通用 OAuth 2.0 提供程序进行身份验证。

智能体功能

本部分列出智能体的功能（工具和知识）。 目前，它仅显示智能体所使用的连接器的详细数据以及知识配置，如以下部分所述。

每个智能体的清单包含每种类型的资源的限制为 200。 在已知限制中了解详细信息。

库存会自动移除重复的资源，例如您在智能体中以相同配置重复配置的 Power Platform 连接器。

连接器属性

库存包括一个名为 powerPlatformConnectors 的数组，其中包含在智能体中配置的 Power Platform 连接器。 每个连接器都通过其 connectorId（即包含连接器的资源 ID 的字符串，例如 shared_excelonlinebusiness）进行标识。 对于每个配置的连接器，有一个已配置 operations 列表。 该列表包括以下属性：

属性 数据类型 说明 执行状态
OperationId 字符串 连接器内特定操作的 ID，例如 AddRowV2 预览版
createdBy GUID 配置操作的用户 预览版
isEnabled boolean 连接器操作当前是否已启用 预览版
usedAs 字符串 操作的使用方式：
  • Tool，如果配置为通用工具
  • 如果在特定主题中配置为工具，为 Topic Tool
  • Knowledge，如果连接器配置为知识来源
 预览版
requiresEndUserConsent boolean 最终用户是否必须同意，智能体才能使用该操作 预览版
whenCanBeUsed 字符串 何时可以调用该操作：
  • Anytime，如果智能体可以无限制地使用该工具
  • 如果智能体仅在制作者在特定主题中显式配置了工具时使用该工具，为 ViaDirectReferenceOnly
  • Conditional，如果智能体可以按照制作者预定义的逻辑使用该工具
 预览版
connectionProvider 字符串 提供操作连接的人员：
  • 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
    }
  }
}

知识属性

库存包括知识的以下属性：

属性 数据类型 说明 Status
IsWebSearchEnabledForKnowledge boolean 如果智能体可以使用 Web 搜索作为知识来源，则为 True 预览版

已知限制

  • V1 智能体未跟踪 - 该库存不包括使用原始 Power Virtual Agents V1 运行时创建的智能体。 它仅跟踪 V2 (Copilot Studio) 智能体。
  • 标识属性可能不适用于所有智能体 - 仅针对使用较新的 Entra 智能体标识模型预配的智能体填充 entraAgentId 和 entraAgentBlueprintId 字段。 较旧的智能体可能仅包含 entraAppId，智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 智能体生成器智能体没有其中任何标识属性。
  • 功能计数 - 每个智能体的库存包含每种类型的资源上限为 200。 如果智能体从特定类型中配置了超过 200 个资源（例如 Power Platform 连接器），库存将随机显示 200 个。 管理员可以使用 capabilitiesCounts 字段了解针对每种类型在智能体中配置的资源数量。

相关内容

  • Last updated on