使用 Power Platform API 以编程方式删除代理

Copilot Studio为管理员提供强大的工具来管理代理安全性和合规性，包括通过Power Platform API删除代理的功能。

删除代理程序是 Copilot Studio 安全框架的重要组成部分，并与 Copilot Studio 的整体安全策略紧密结合。

例如，审核、运行时保护和其他管理员报告或通知可以标记违反组织安全性和身份验证要求的代理。 管理员可以使用该 delete 操作来删除不符合的代理，同时调查和修正安全性和合规性问题。

删除代理时，请将其从环境中删除。 制作者和之前的用户无法再看到这些文件。

删除具有Microsoft Entra 智能体 ID的代理时，也会从Microsoft Entra ID中删除关联的代理 ID（或旧代理的应用注册）。 有关详细信息，请参阅 自动创建Microsoft Entra代理标识。

重要

该 powervirtualgents 命名空间已被弃用。 在 API 调用中使用 copilotstudio 命名空间。

先决条件

  • 您有目标代理的机器人ID与环境ID。
  • 您必须获得由 Microsoft Entra ID OAuth2 颁发的用户访问令牌。 若要获取令牌，请参阅 “身份验证”。
    • 与令牌关联的用户必须具备以下管理角色之一：
      • 全局租户管理员
      • 人工智能管理员
      • Power Platform 管理员
    • 必须使用具有在 Power Platform API 下授予的 CopilotStudio.AdminActions.Invoke 范围的应用程序注册的客户端 ID 来获取访问令牌。

智能体删除的 API 操作

Copilot Studio作为 Power Platform API 的一部分，支持用于删除代理的 REST API delete 操作。

有关如何以及何时使用 Power Platform API 的详细信息，请参阅：

删除代理

  • 终结点：DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
  • 目的：永久删除代理
  • 回复：如果代理成功删除，则返回204 OK

有关详细信息，请参阅 Delete Copilot 代理 API 参考文档。

  • Last updated on