在 Microsoft 365 管理中心管理代理注册

Microsoft 365 管理中心中的代理注册表提供组织可用的所有代理的集中视图。 此列表可帮助你监视、管理和治理组织的代理程序。

查看代理注册表

  1. 登录到 Microsoft 365 管理中心。

  2. 在左侧导航窗格中，选择 Agents>All Agents>Registry。

    租户可用代理列表的屏幕截图。

代理类型

代理 注册表 列出了组织可用的所有代理。 代理分为四种主要类型，如下表所示：

代理类型 Description
Microsoft 代理 由 Microsoft 构建并维护的代理。
外部合作伙伴构建的代理 由受信任的非 Microsoft 开发人员构建并发布，以供更广泛使用或公开提供的代理。
由您的组织发布 由您的组织批准和发布的自定义代理，以便更广泛地使用。 这些代理可能称为 LOB (业务线) 代理。
由创建者共享 由组织中的单个用户或开发人员创建和共享的代理。 这些代理通常称为共享代理。

Note

相同的 Copilot Studio 代理 (声明式或自定义引擎) 可以在具有不同发布者类型的注册表中多次出现，例如“由创建者共享”和“由组织发布”。这些看起来重复的行是按预期设计的。 它们表示同一基础代理的单独生命周期和发布方记录，而不是清单错误。

有关生命周期详细信息和可用的管理员操作，请参阅 一个代理如何显示为多个条目。

一个代理如何显示为多个条目

对于自定义引擎代理，它在注册表中的显示方式取决于其发布生命周期以及创建者和管理员采取的操作：

  • 单独在 Copilot Studio 中发布代理可能无法使其在管理中心可见。
  • 选择在 Microsoft 365 中查看代理将创建一个“由创建者共享”条目，创建者通常会使用此条目来测试代理，然后再更广泛地共享代理。
  • 选择向组织中的每个人显示智能体并将其提交以供管理员批准，然后由管理员发布它，将创建“由你的组织发布”条目。

可用的管理员操作因代理类型和发布者状态而异。 例如，某些条目提供 删除，其他条目提供 移除，而某些条目仅提供 阻止。 删除一个条目不会删除另一个条目。 有关更多信息，请参阅 您可以管理的代理类型。

代理注册表摘要

代理 注册表 提供有关组织可用的代理的快速详细信息，如下表所示：

租户范围的代理详细信息 Description
代理总数 你的组织的租户中的可用代理数量。

注意： 将筛选器应用于代理列表不会更改 代理总数。
无所有者的代理程序 在你的组织中不再具有所有者的坐席数量。
非托管代理 在 Agent 365 之外创建或管理、因而不受其风险防护和可观测性支持的代理数量。

代理注册表筛选器

代理 注册表 可以包含大量且多样化的代理清单。 随着组织代理采用率的增加，所有代理的管理可能会更加繁琐且复杂。 除了按列对代理列表进行排序外，您还可以过滤列表。 筛选此列表有助于将视图范围缩小到当前要关注的代理，从而允许您：

  • 提高效率。
  • 做出有针对性的决策。
  • 更好地应用智能体治理流程。

可以根据以下条件筛选代理列表：

  • 状态 - 可以根据代理的状态筛选代理列表。
  • 发布者类型 - 发布者筛选器指示谁拥有和分发代理，而不是在何处或如何构建代理。 此筛选器主要用于区分 Microsoft 代理、外部合作伙伴构建的代理和由你的组织发布的内部自有代理。
  • 通道 - 通道筛选器是代理部署到的渠道。 它是组织成员可以发现代理并与之交互的界面。 频道值包括 Copilot、 Teams、 Outlook、 Microsoft 365 应用和 SharePoint。
  • 平台 - 平台筛选器指示用于创建代理程序的平台或产品。
  • 数据源 - 数据源筛选器允许您选择 内置知识 和 微调模型 作为数据源选项。 嵌入的知识是指包含由代理制作者或开发人员上传作为知识源的文件的代理。 微调模型指示代理是使用 Microsoft Copilot 调整创建的，允许代理使用自己的组织数据微调 LLM。

Tip

如果在代理注册表列表中看不到希望看到的代理，请检查以确保没有现有的筛选器集。

某些列允许您对代理注册表列表进行排序。 若要对列表排序，请选择列标题。

将筛选器应用于代理列表不会更改 代理总数。

代理注册表操作

代理 注册表 提供与租户的代理列表特定相关的代理操作，如下表所示：

Action Description
刷新 更新列表以提供代理列表的最新视图。
Export 将代理程序导出到 CSV 文件。 此操作可能需要一些时间，具体取决于租户中的代理数量。 有关详细信息，请参阅 导出到 Excel。
添加代理 提供 (.zip) 上传代理清单文件的方法。 有关详细信息，请参阅 上传自定义代理。
管理已固定的代理 选择要为用户固定的代理。 固定的代理在代理已部署到的每个可用渠道中更突出地显示。 您可以通过在此列表中上下移动固定坐席来更改固定坐席的优先级。 如果用户有三个以上的置顶代理，则用户不会看到优先级较低的代理。 有关详细信息，请参阅 托管已固定的代理。
自定义视图 自定义代理列表中显示的列。 有关详细信息，请参阅 自定义视图。
搜索 使用搜索选项在代理 注册表中快速查找代理。

Tip

除了上述操作外，您还可以通过选择列表图标（位于搜索框旁边），将列表视图从普通列表更改为紧凑列表。

无所有者的代理程序

当您从组织中删除创建共享代理的用户时，共享代理可能会变得无所有者。

为了帮助管理员管理这些方案，Microsoft 365 管理中心使你能够识别和管理无所有者共享智能体。 仪表板显示此类代理的总数、用于快速隔离它们的一键式过滤器以及反映用户删除的实时更新。 当管理员使用这些功能时，他们可以通过阻止或删除受影响的代理项来有效地审查和解决所有者缺失问题。

无所有者代理视图的屏幕截图。

当您选择“没有所有者的代理”卡时，将筛选代理列表，以根据发布者类型和所有者显示代理。 您可以查看没有所有者的代理列表，并为每个代理执行适当的操作，例如 阻止 或 删除 代理。

主要功能

  • 无所有者代理计数 - 管理员可以直接从仪表板查看没有有效所有者的代理总数。 例如，仪表板显示有 20 个无所有者的代理，这表明这些代理是由离开组织的用户创建的。
  • 一键式筛选 - 选择仪表板窗格可立即筛选代理列表，以仅显示缺少所有者的共享代理。 此功能允许快速分类处理和采取措施。
  • 实时更新 - 从组织中硬删除用户时，无所有者坐席数量会自动更新。 此功能可确保仪表板反映当前状态，而无需手动刷新。

代理风险

Note

更新后的风险详细信息体验正在逐步推出。 如果看到之前的界面，则更新后的体验尚未到达你所在的区域。

代理注册表中的风险信号是一组与代理相关的安全检测，可为 IT 管理员提供其租户中代理风险的单一视图。 通过将来自多个安全平台的信号集中到一个地方，IT 管理员无需在各个门户之间切换，也无需将权限提升到不同安全角色所需的级别，就可以了解被标记的内容。

当代理的活动与组织的安全策略冲突时，安全平台会检测风险信号。 可以与安全团队共享这些详细信息，以便进行调查和修正。

查看风险信号的先决条件

  • 你的租户必须具有 E7 或 A365 许可证。 若要在 Microsoft 365 管理中心查看订阅，请选择“计费>许可证>订阅”。 有关详细信息，请参阅 代理管理许可。

风险列和风险详细信息

所有代理页面上的风险列显示每个代理的风险信号的汇总计数。 选择该计数时，风险详细信息窗格将打开。 此窗格提供代理风险信号的聚焦且可操作的视图。 它提供：

  • 全面覆盖所有高、中、低风险信号。
  • 风险信号分为可展开的高、中和低严重性部分。
  • 单个风险信号的详细描述。
  • 每个单独风险信号的 出现次数 计数，显示该信号被引发的次数。
  • 风险信号源自：显示为该代理程序提供风险信号的 Microsoft 安全平台，例如 Microsoft Purview、Microsoft Entra 和 Microsoft Defender。 仅显示具有贡献信号的平台。 每个平台名称都是指向相应门户的深层链接，以便进一步调查，具体取决于用户的角色和权限。
  • 当代理具有多个实例时，风险信号按实例分组，允许您向下钻取到所选代理实例的聚合信号。

“所有代理”页面的屏幕截图，其中显示了“风险”列，其中包含每个代理的聚合风险信号计数。

“风险详细信息”窗格的屏幕截图，其中显示了分组为可扩展的“高”、“中”和“低”严重性部分的源链接和风险信号。

Important

Microsoft 365 管理中心中的风险信号计数最多可能比安全门户中显示的滞后一小时。 计数反映当前有效的风险信号。 计数为零表示当前在连接的平台上未检测到该代理的活动信号。

安全门户 所需角色 — 任何一个
Microsoft Entra 全局管理员、全局读取者、安全读取者、安全管理员或 AI 管理员
Microsoft Defender 全局管理员、全局读取者、安全读取者、安全管理员或 AI 管理员
Microsoft Purview - IRM 警报 IRM 分析师或 IRM 调查员。 仅使用全局管理员是不够的;全局管理员可为自己分配其他 IRM 角色。

“有风险的代理程序”磁贴

“所有代理”页面上的“有风险的代理”磁贴显示租户中具有一个或多个风险信号的代理总数。 选择磁贴将打开一个预筛选视图，仅显示检测到风险信号的代理，以便您可以确定调查和补救的优先级。

“所有代理”页面上“有风险的代理”磁贴的屏幕截图，显示了具有风险信号的代理总数。

“概览”页面上的高风险坐席卡片

Microsoft 365 管理中心“概述”页上的“处于风险中的代理”卡片列出了 Microsoft 安全平台和连接的第三方平台上聚合风险计数最高的三个代理。

Microsoft 365 管理中心“概述”页上“有风险的代理”卡的屏幕截图，其中列出了前三名风险最高的代理。

选择 查看代理 以打开 所有代理>注册表，其中列表按风险级别进行筛选和排序，以便可以确定调查和修正的优先级。

上传自定义代理

Microsoft 365 管理中心内的代理 Registry 提供了一种上传自定义代理的方法，以便你可以为组织管理这些代理。

Note

还可以在 Agent Store 中更新现有代理。 有关详细信息，请参阅 查看代理详细信息。

要上传代理程序，代理程序必须包含在 ZIP 数据包文件中。 ZIP 文件包含资源，例如清单文件、配置文件、图标、品牌和嵌入式知识文件。

Note

可以从 Copilot Studio 或 Copilot 中的代理生成器下载代理 ZIP 文件。

若要从 Copilot Studio 下载代理 ZIP 文件，请选择 代理>你的代理名称>频道。 选择用于发布的频道，例如 Teams 和 Microsoft Copilot。 选择 可用性选项>下载 .zip。

若要从 Copilot 中的代理生成器下载声明性代理 ZIP 文件，请选择所有代理>选择代理旁边的省略号>编辑>选择右侧的省略号>下载 .zip 文件。

若要将代理作为 ZIP 数据包文件上传到 Microsoft 365 管理中心，请执行以下操作：

  1. 在 Microsoft 365 管理中心，选择 代理>所有代理>添加代理。

  2. 选择 “选择文件” 以查找并选择代理 ZIP 文件。 ZIP 文件已经过验证。 然后选择下一步。

  3. 验证代理的名称、图标和宿主产品。

  4. 在 “发布”下，选择可以安装代理的用户或组。

    Microsoft 365 管理中心中代理 ZIP 上传期间向用户发布时的屏幕截图。

  5. 在 “部署 (可选) ”下，选择将预安装代理的用户或组。 然后选择下一步。

    Note

    可以选择一小部分受众进行测试。 例如，选择仅限我或单个测试组，以缩小代理的可用范围。

  6. 选择应用现有策略模板、自定义策略或默认策略。 有关更多现有策略模板信息，请参阅 安全模板。 Agent 365 用户可以应用选定的自定义策略和保护。 默认策略和保护通过安全平台进行管理。 检查平台中每项的状态。 请注意，可能未启用策略和保护。 然后选择下一步。

    在 Microsoft 365 管理中心中上传代理 ZIP 期间'应用安全模板'的屏幕截图。

  7. 查看代理权限。 然后选择下一步。

  8. 查看并已完成。 选择 “完成部署”。

    Note

    如果租户使用统一代理和应用管理，则对 Microsoft 365 管理中心 (MAC) 中组织范围租户设置的所有更改都会自动在 Teams 管理中心 (TAC) 同步，反之亦然。 有关详细信息，请参阅 统一代理和应用管理。

管理置顶的代理

作为管理员，可以选择将已部署的代理固定到 Microsoft Copilot 中的 代理 列表。 通过在 Microsoft Copilot 中固定智能体，可以确保这些智能体对组织的所有成员可见和可访问，或仅对特定用户或组可见和可访问。 您可以选择固定和取消固定坐席。 此外，还可以对已固定的代理列表进行排名。

Microsoft Copilot 包括由 Microsoft、管理员和用户固定的智能体。 Microsoft 固定代理是默认针对所有用户固定的特定代理。 可以在 Microsoft 365 管理中心内为组织固定智能体。 此外，单个用户可以在自己的 Microsoft Copilot Chat 或 Microsoft Copilot 体验中固定代理。

Note

固定智能体后，最终用户可能需要长达 6 小时才能看到固定的智能体。

本部分介绍管理员如何使用 Microsoft 365 管理中心固定、取消固定或管理面向所有人或特定组的智能体。 它还涵盖相关操作，例如调整固定代理列表的顺序和编辑固定代理的范围。

固定智能体是一项功能，使管理员能够使用 Microsoft Copilot 为最终用户预先选择并固定智能体。 管理员固定代理以确保代理自动显示在最终用户的 Copilot 界面中，而无需任何用户操作。 现在，用户可以在 Copilot 界面中轻松访问代理。

Prerequisites

要固定代理程序，以便组织成员更容易看到和访问每个代理程序，您的用户（组织成员）需满足先决条件。 此外，您必须具有特定的权限和角色。

对于最终用户 - 组织成员必须有权访问以下内容：

  • Microsoft 365 工作帐户
  • 对 Microsoft Copilot 对话助手 的访问权限（例如，可通过 Teams、Web 或 Microsoft Copilot 应用）
  • 要置顶的代理必须可由组织成员发现

对于管理员 - 作为管理员，您必须具有以下角色和访问权限：

  • AI 管理员
  • 访问 Microsoft 365 管理中心
  • （可选）Power Platform 管理中心访问权限（如果你对智能体使用即用即付）

已固定代理

Microsoft Copilot 中代理的屏幕截图。

已固定的 Microsoft 代理

  • 这些代理是 Microsoft 默认为所有用户置顶的代理。
  • 确保基本或高价值代理（如核心 Copilot 功能）始终可见。
  • 最终用户无法取消置顶这些代理程序。 它们已固定在置顶列表中。

管理员置顶的代理

  • 由组织的管理员通过 Microsoft 365 管理中心置顶。
  • 可以固定时长：
    • 所有用户。
    • 特定组。
    • 特定用户。
  • 最终用户通常无法取消置顶这些智能体。 它们已固定在置顶列表中。

用户固定的代理程序

  • 由单个用户在其自己的 Microsoft Copilot 对话助手 体验中固定。
  • 用户可以：
    • 置顶您经常使用的代理。
    • 随时取消固定它们。
  • 此列表完全由用户控制，但 Microsoft 固定或管理员固定的代理除外，它们保持锁定状态。

Features

  • 管理员固定的智能体默认情况下会向最终用户显示，这使得它们更容易被发现，并有助于突出显示新的或重要的智能体。
  • 管理员可以在 Microsoft 365 管理中心查看 Microsoft 固定的智能体。
  • 管理员可以在 Microsoft 365 管理中心为组织中使用 Microsoft Copilot 的最终用户固定最多三个智能体。
  • 管理员可以选择为租户中的所有用户固定代理，或为特定用户或组固定代理。 例如：
    • 仅为销售部门固定 Sales Coach 代理。
    • 为所有用户固定 HR Q&A 智能体。
  • 最终用户无法取消固定由管理员固定和由 Microsoft 固定的代理。

置顶代理

可以使用以下步骤选择将代理固定：

  1. 在“ 所有代理 ”页面中，选择右侧的省略号以显示下拉菜单。

  2. 选择“管理已固定的代理”。 在“ 固定的代理 ”窗格中，会显示由 组织固定 的代理和由 Microsoft 固定 的代理列表。

  3. 选择“ 固定代理 ”以固定新代理。

  4. 在“ 选择要固定的代理 ”窗格中，从代理列表中查找要固定的代理。 您可以搜索列表以按名称查找特定代理。 只能固定部署到部分或所有用户的代理。

    Microsoft 365 管理中心中代理选择列表的屏幕截图。

  5. 找到所需的代理后，选择它，然后选择 下一步。

  6. 在 选择哪些人将看到此代理被固定 窗格中，选择要固定此代理的范围。

    • 代理部署到的所有用户 - 为租户中代理部署到的所有用户固定代理。

      Note

      如果看不到此选项，则所选代理可能未部署。

    • 代理部署到的特定用户或组 - 固定一个或多个组或单个帐户。

    用于在 Microsoft 365 管理中心中固定代理的范围选择窗格的屏幕截图。

  7. 如果选择特定用户或组作为代理部署对象，请选择要固定代理的特定用户或组。

    用于置顶代理的用户和组选择列表的屏幕截图。

  8. 选择“保存”。

  9. 保存配置后，系统会记录为所选受众固定了哪个代理。

    Microsoft 365 管理中心中固定代理列表的屏幕截图。

可固定的智能体

只能置顶已部署的代理。 如果代理未部署，你会看到一个横幅，其中包含一条要求首先部署代理的消息。

要求您先部署代理的消息截图。

如果代理被封禁，请在置顶该代理之前先解除封禁。

要求你首先解除对代理的阻止的消息屏幕截图。

对置顶代理列表排序

  • 管理员为每个用户的置顶代理保留了三个槽位。

  • 管理员可以使用 “上移” 和“ 下移 ”按钮按优先级重新排序固定代理列表，以控制向用户显示的内容。

取消固定代理程序

从已固定代理列表中，找到要取消固定的代理，然后选择 取消固定。 取消固定后，代理将在“由组织固定”部分下不再可用。

编辑代理的固定范围设置

选择代理，然后选择编辑用户以修改该代理固定到的用户范围。

用于在 Microsoft 365 管理中心固定代理的“编辑用户”选项的屏幕截图。

用于置顶的备用入口点

还可以从代理详细信息窗格固定代理。 选择用户图标的 PIN 码。 仅当代理已部署时，该图标才会启用。

Microsoft 365 管理中心中代理详细信息窗格的屏幕截图。

自定义视图

可以自定义“ 所有代理 ”页面上提供的代理列表。 你可以选择要显示的列。

Microsoft 365 管理中心中“自定义视图”窗格的屏幕截图。

Microsoft 图形 API 代理注册表和代理详细信息（预览版）

你还可以通过 Microsoft Graph API 以编程方式访问代理注册表数据，这使你能够对代理管理实现可扩展的程序化控制。 通过使用新的 Microsoft 图形 API 端点（现已处于预览状态），管理员可以将以下任务集成到 Microsoft 365 中跨代理的现有工作流中：

  • 自动执行批量代理程序管理。
  • 简化新手引导。
  • 整合治理。

除了 UX 驱动的手动代理管理之外，Microsoft 图形 API 还可帮助你加速代理管理、维护安全性和合规性，并确保在正确的时间为正确的用户提供代理。

  • 获取资产清单中的所有代理 - 通过使用 GET 包 API，管理员可以检索其租户中所有代理的完整列表，以支持合规性和报告需求。

  • 获取库存中特定代理的详细信息 - GET 包详细信息 API 为任何代理提供丰富的元数据和详细信息，使审计、管理和优化代理管理变得更加容易。

API 支持 AI 管理员角色。 有关详细信息，请参阅 代理和应用包管理 API 概述 (预览版) 。

以下示例演示如何使用 Microsoft Graph PowerShell 检索租户中所有代理程序的列表。

Connect-MgGraph -Scopes 'CopilotPackages.Read.All'

$uri = "https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages"
$agentCount = 0

do {
    $response = Invoke-MgGraphRequest -Method GET -Uri $uri
    $agentCount += @($response.value).Count
    $response.value | ForEach-Object { Write-Host $_.displayName }
    $uri = $response.'@odata.nextLink'
} while ($uri)

Write-Host "Total agents: $agentCount"

为用户和代理导出到 Excel

可以将代理列表导出到 Excel 文件。 将导出范围设置为 “所有代理 ”或 “筛选的代理 ”以进行分析和报告。

导出可以包括代理详细信息，例如：

  • Name
  • Status
  • 频道
  • 创建日期
  • 上次修改
  • Publisher
  • 发布者类型
  • 版本
  • Owner
  • Description
  • Platform
  • Instructions

Tip

每个代理有 30 多种不同的项目可以包含在导出列表中。

借助这些信息，您可以有效地管理和审查组织内的共享代理，确保合规性并优化资源分配。

将过去 30 天的活跃用户列表导出到 Excel 文件。 此功能对于详细分析和报告至关重要。

导出的文件包括有关每个活动用户的全面信息，例如：

  • 用户主体名称
  • 使用的代理总数
  • 会话总数
  • 上次活动日期

其他信息

Important

包括 [目录/注册表/产品/服务名称] 中提供的第三方 MCP 服务器在内的非 Microsoft 工具（“第三方工具”），根据您关于使用相应 Microsoft 产品的协议，属于非 Microsoft 产品。 连接到第三方工具时，将自行承担风险。 你负责与使用第三方工具相关的任何条款和收费。 Microsoft对你或使用第三方工具的其他人没有任何责任。 建议仔细检查并跟踪添加到 MCP 客户端的第三方工具。

您的某些信息和数据 (（如身份验证密钥和提示内容) ）可能会传递给第三方工具，或者您的 MCP 客户端可能会从第三方工具接收数据。 建议查看与第三方工具共享的所有数据，并了解第三方在数据保留和位置方面的做法。 您有责任决定并控制您的数据是否会流出组织的合规性和地理边界，以及任何相关影响。

MCP 实现容易受到攻击、级联失败和人员监督损失等风险的影响。 可以通过审查 MCP 服务器的安全性和可靠性、遵循 Microsoft 的建议做法 和行业 最佳做法、实施审批机制和监视级联行为来缓解这些风险。

仅为方便起见，Microsoft 提供了终结点，以促进通过受监视的网关在与 MCP 服务器之间传输数据。 建议查看涵盖由 Microsoft 启用的任何监视工具的你的配置的所有技术文档。 这些端点并不暗示，也不应被解释为对任何第三方工具的认可、归属或拥有关系。 相应的许可方（而非 Microsoft）向你提供第三方 MCP 服务器。 就使用第三方 MCP 服务器，Microsoft 对你或其他人不承担任何责任。

  • 上次更新时间为