用于Copilot Studio的代理注册表集成

创建代理时，Microsoft Copilot Studio代理会自动显示在代理注册表中，从而在整个租户中提供集中可见性、治理和管理。 管理员使用代理注册表来发现、监视和控制组织范围内的代理。

本文介绍如何Copilot Studio代理与代理注册表集成，以及管理员可以看到哪些元数据。

代理注册表

代理注册表是Microsoft 365租户中所有代理的集中清单：

• 统一事实来源：查看所有跨平台代理程序（Copilot Studio、专业编程、非微软）。
• 租户范围内的可视性：管理员可以监控所有环境和团队中的代理。
• 治理控制：将策略、权限和操作应用于代理。
• 合规性跟踪：审核代理元数据、权限和使用情况。

代理注册表通过 Microsoft 365 管理中心 访问，然后选择 Agent 365。

代理注册表不同于 Power Platform 管理中心，因为它提供跨所有平台的租户范围的可见性，而 Power Platform 清单 仅显示环境中特定于 Power Platform 的应用。

Copilot Studio代理在注册表中的显示方式

Copilot Studio 的代理在创建后会自动注册。

注册时间安排

可见元数据

管理员查看每个Copilot Studio代理的以下信息。

基本信息：

• 代理名称和说明
• 发布者 信息（创建者电子邮件、组织）
• 代理类型（Copilot Studio基于应用）
• 创建和上次修改日期
• 代理 ID （唯一标识符）
• 使用的 Power Platform 连接器

配置详细信息：

• 部署状态
• 启用或禁用状态
• 版本信息（如果适用）

治理元数据：

• 通过 Power Platform 策略预审批状态
• 应用的数据丢失防护 （DLP） 策略
• 高级连接器策略符合性

Copilot Studio自动同步此元数据。 无需手动输入。

代理注册表与 Power Platform 应用目录

Copilot Studio代理同时出现在代理注册表和 Power Platform 应用程序目录中，但每个代理都提供不同的用途。

对于开发人员，这两个注册表都显示了Copilot Studio代理，但代理注册表提供了代理 365 集成层，包括可观测性、治理控制和合规性。

注册生命周期

Copilot Studio代理遵循自动注册生命周期。

1. 创建

创建Copilot Studio代理时：

• 自动预配的 Entra 标识（请参阅 代理标识集成）
• 代理在几秒钟内出现在注册表中
• 从Copilot Studio同步的元数据
• 状态：激活（根据 Power Platform 策略已预先批准）

2. 更新

当您修改代理时：

• 元数据更改（名称、说明）：注册表自动更新
• 权限更改（新连接器）：注册表已更新，DLP 策略重新评估
• 配置更改：注册表反映当前状态

无需手动重新注册。

3. 删除

删除Copilot Studio代理时：

• 自动删除注册表项
• 已删除 Entra 标识
• 清理了所有关联的元数据
• 历史遥测保留（请参阅 可观测性集成）

管理员体验：查看Copilot Studio代理

管理员从Microsoft 365 管理中心访问代理注册表。 转到 Microsoft 365 管理中心>Agent 365>Agent 注册表。

可用视图：

• 所有代理：跨平台查看所有代理
• 按平台过滤：仅显示Copilot Studio代理
• 按发布者筛选：显示来自特定团队或用户的代理
• 按状态筛选：显示活动代理、阻止代理或重新分配代理

代理详细信息页：

• 查看完整的代理元数据
• 查看请求的权限和范围
• 查看可观测性数据（使用情况、性能、错误）
• 应用治理操作（阻止、重新分配、删除）

有关详细的管理员指南，请参阅：

• 代理注册表
• 管理代理

对Copilot Studio代理的治理控制

管理员可以通过代理注册表将治理操作应用于Copilot Studio代理。

屏蔽

防止代理在组织范围内使用：

• 代理保留在注册表中，但变为非活动状态
• 用户无法调用或与代理交互
• 代理创建者收到通知
• 管理员稍后可以取消阻止

重新分配

将代理所有权转让给其他用户或团队：

• 新所有者获得完全控制和编辑权限
• 原始所有者失去访问权限
• 使用新的发布者更新的注册表元数据
• 对团队转换或组织更改非常有用

Delete

从注册表和租户中删除代理：

• 代理生成器代理：代理所有者可以通过注册表删除
• Copilot Studio中生成的代理：需要 Power Platform 环境管理员权限
• 代理标识已从 Entra ID 中删除
• 已删除注册表项
• 已删除所有配置和元数据
• 保留历史遥测以满足合规性要求

所有治理操作都记录在Microsoft Purview，以便进行合规性跟踪。

有关治理控制的详细信息，请参阅 “管理代理”。

编程访问：图形 API

管理员可以使用 Microsoft Graph API 以编程方式访问代理注册表数据。

可用 API：

• 列出所有代理：检索符合性和报告的完整清单
• 获取代理详细信息：获取用于审核的特定代理的元数据

用例：

• 批量代理管理和自动化
• 与现有治理工作流集成
• 自定义报告和分析
• 合规性审核和监视

使用场景需要 AI 管理员或全局管理员角色权限。

有关 API 详细信息，请参阅 图形 API，了解代理注册表和代理详细信息。

开发人员注意事项

作为Copilot Studio开发人员，请记住这些注册表集成点。

元数据质量：

• 使用清晰的描述性代理名称和说明（对管理员可见）
• 代理说明中的文档连接器使用情况和权限
• 保持代理元数据的最新状态

权限透明度：

• 管理员在注册表中看到所有请求的权限
• 仅添加实际需要的连接器
• 了解控制连接器使用情况的 Power Platform 策略

可观测性集成：

• 可观测性数据的注册表链接（使用情况、性能、错误）
• 管理员可以监视代理的活动
• 考虑到可观测性的设计代理（请参阅 可观测性集成）

治理意识：

• 管理员可以阻止、重新分配或删除代理
• 设计代理以优雅地处理停用
• 与管理员就高特权连接器需求进行通信

后续步骤

• 查看 可观测性集成 ，以了解代理活动的监视方式。
• 请参阅 代理标识集成 ，了解自动标识预配。
• 读取管理员视角的 代理注册表 。
• 浏览代理注册表的 图形 API，以便进行编程访问。