Freigeben über

Programmgesteuertes Löschen von Agents mithilfe der Power Platform-API

Copilot Studio bietet Administratoren robust Tools zum Verwalten der Agentsicherheit und -compliance, einschließlich der Möglichkeit, Agents über die Power Platform-API zu löschen.

Das Löschen von Agents ist Teil des umfassenderen Sicherheitsrahmen von Copilot Studio und arbeitet Hand in Hand mit Ihrem allgemeinen Sicherheitsansatz in Copilot Studio.

Beispielsweise können Audits, Laufzeitschutz und andere Administratorberichte oder Benachrichtigungen Agents kennzeichnen, die gegen die Organisationsanforderungen für Sicherheit und Authentifizierung verstoßen. Administratoren können den delete Vorgang verwenden, um nicht kompatible Agents zu entfernen, während Sicherheits- und Complianceprobleme untersucht und behoben werden.

Wenn Sie Agents löschen, entfernen Sie sie aus Ihrer Umgebung. Hersteller und frühere Nutzer können sie nicht mehr sehen.

Wenn Sie einen Agent löschen, der über eine Microsoft Entra-Agent-ID verfügt, wird auch die zugeordnete Agent-ID (oder die App-Registrierung für Legacy-Agents) aus Microsoft Entra ID entfernt. Weitere Informationen finden Sie unter Automatisch erstellen Microsoft Entra Agentidentitäten.

Wichtig

Der Namensraum powervirtualgents ist veraltet. Nutze den copilotstudio Namespace in deinen API-Aufrufen.

Voraussetzungen

  • Sie verfügen über die Bot-ID und die Umgebungs-ID für den Ziel-Agent.
  • Sie müssen ein Benutzerzugriffstoken abrufen, das von Microsoft Entra ID OAuth2 ausgestellt wurde. Informationen zum Abrufen eines Tokens finden Sie unter Authentifizierung.
    • Der Benutzer, der mit dem Token verknüpft ist, muss eine der folgenden Admin-Rollen haben:
      • Für globale Mandantenadministration zuständige Person
      • KI-Administrator
      • Power Platform Administrator
    • Sie müssen das Zugriffstoken mithilfe der Client-ID einer App-Registrierung abrufen, die den Bereich CopilotStudio.AdminActions.Invoke unter der Power Platform-API gewährt hat.

API-Vorgänge für die Agentlöschung

Copilot Studio unterstützt als Teil der Power Platform-API die REST-API delete-Vorgang zum Entfernen von Agents.

Weitere Informationen dazu, wie und wann die Power Platform-API verwendet werden soll, finden Sie unter:

Agent löschen

  • Endpunkt:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
  • Zweck: Einen Agenten dauerhaft löschen
  • Antwort: Wird zurückgegeben 204 OK , wenn der Agent erfolgreich gelöscht wurde

Weitere Informationen finden Sie in Delete Copilot Agent-API-Referenzdokumentation.

  • Last updated on