Agents programmatisch verwijderen met behulp van de Power Platform-API

Copilot Studio biedt beheerders robuuste hulpprogramma's om de beveiliging en naleving van agents te beheren, met inbegrip van de mogelijkheid om agents te verwijderen via de Power Platform-API.

Note

De delete API-operatie ondersteunt alleen Agent Builder-agenten.

Het verwijderen van agents maakt deel uit van het bredere beveiligingsframework van Copilot Studio en werkt samen met uw algehele beveiligingsbenadering in Copilot Studio.

Controles, runtimebeveiliging en andere beheerdersrapporten of -meldingen kunnen bijvoorbeeld agents markeren die in strijd zijn met de organisatievereisten voor beveiliging en verificatie. Beheerders kunnen de delete bewerking gebruiken om niet-compatibele agents te verwijderen tijdens het onderzoeken en oplossen van beveiligings- en nalevingsproblemen.

Wanneer u agents verwijdert, verwijdert u deze uit uw omgeving. Makers en eerdere gebruikers kunnen ze niet meer zien.

Wanneer u een agent verwijdert met een Microsoft Entra Agent-ID, wordt de bijbehorende agent-id (of app-registratie voor verouderde agents) ook verwijderd uit Microsoft Entra ID. Lees meer in Automatisch Microsoft Entra Agent ID's aanmaken.

Important

De powervirtualgents naamruimte is verouderd. Gebruik de copilotstudio naamruimte in je API-aanroepen.

Prerequisites

  • U hebt de bot- en omgevings-ID voor de doelagent.
  • U moet een gebruikerstoegangstoken verkrijgen dat is uitgegeven door Microsoft Entra ID OAuth2. Zie Verificatie om een token te verkrijgen.
    • De gebruiker die aan het token is gekoppeld, moet een van de volgende beheerdersrollen hebben:
      • Globale tenantbeheerder
      • AI-beheerder
      • Power Platform-beheerder
    • U moet het toegangstoken verkrijgen met behulp van de client-id van een app-registratie waarvoor het CopilotStudio.AdminActions.Invoke-bereik is verleend onder de Power Platform-API.

API-bewerkingen voor het verwijderen van agenten

Copilot Studio ondersteunt als onderdeel van de Power Platform-API de REST API delete bewerking voor het verwijderen van agents.

Zie voor meer informatie over hoe en wanneer u de Power Platform-API gebruikt:

Agent verwijderen

  • Eindpunt:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
  • Doel: Een agent permanent verwijderen
  • Reactie: Komt terug 204 OK als de agent succesvol is verwijderd

Meer informatie vindt u in Referentiedocumentatie voor Copilot Agent-API verwijderen.

  • Last updated on