使用 Power Platform API 通过编程删除代理

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

删除代理是 Copilot Studio 更广泛安全框架的一部分，并与 Copilot Studio 中的整体安全方法密切配合。

例如，违反组织安全和认证要求的代理可以在审计、运行时保护或其他管理员报告或通知中被标记。 管理员随后可以使用delete操作来移除不合规的代理，同时调查和修复安全及合规问题。

已删除的代理程序将从你的环境中移除。 制作者和之前的用户无法再看到这些文件。

重要

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

先决条件

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

智能体删除的 API 操作

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

有关 Power Platform API 的使用时机与方法，请参阅：

• Power Platform API 和 SDK：从用户体验优先到 API 优先（博客）（Power Platform 开发者博客）
• 可编程性与可扩展性概述（Power Platform 文档）
• 开始使用 Power Platform API （Power Platform 文档）
• Power Platform API 操作参考文档

删除代理

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

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