透過使用 Power Platform API 程式化刪除代理程式

Copilot Studio 為管理員提供穩健的工具來管理代理程式的安全與合規性，包括透過 Power Platform API 刪除代理的功能。

Note

API delete 操作僅支援代理建構代理。

刪除代理是 Copilot Studio 更廣泛安全架構的一部分， 與 Copilot Studio 的整體安全策略協同運作。

例如，稽核、執行時保護及其他管理員報告或通知，可能會標記違反組織安全與認證要求的代理程式。 管理員可利用此 delete 操作移除不合規的代理，同時調查並修復安全與合規問題。

當你刪除代理時，就是把他們從你的環境中移除。 創作者和過去的使用者已經無法再看到這些內容。

當你刪除帶有 Microsoft Entra Agent ID 的代理時，相關的代理 ID（或舊版代理的應用程式註冊）也會從 Microsoft Entra ID 中移除。 了解更多請參閱「自動建立 Microsoft Entra 代理 ID」。

Important

該 powervirtualgents 命名空間已被棄用。 在你的 API 呼叫中使用 copilotstudio 命名空間。

先決條件

  • 您有目標 Agent 的機器人識別碼和環境識別碼。
  • 您必須取得由 Microsoft Entra ID OAuth2 發行的使用者存取權杖。 要取得代幣，請參見認證。
    • 與該令牌相關的使用者必須具備以下其中一個管理員角色：
      • 全域租戶系統管理員
      • AI 管理員
      • Power Platform系統管理員
    • 您必須使用具備 CopilotStudio.AdminActions.Invoke 範圍的應用程式註冊客戶端 ID，透過 Power Platform API 取得存取權杖。

代理刪除的 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 Agent API 參考文件。

  • 上次更新時間：