Slet agenter programmatisk ved hjælp af Power Platform-API'en

Copilot Studio giver administratorer robust-værktøjer til administration af agentsikkerhed og -overholdelse, herunder muligheden for at slette agenter via API'en til Power Platform.

Sletning af agenter er en del af Copilot Studio bredere sikkerhedsstruktur og works sammen med din overordnede sikkerhedstilgang i Copilot Studio.

Overvågninger, kørselsbeskyttelse og andre administratorrapporter eller meddelelser kan f.eks. markere agenter, der overtræder organisationens krav til sikkerhed og godkendelse. Administratorer kan bruge handlingen delete til at fjerne agenter, der ikke overholder angivne standarder, mens de undersøger og afhjælper problemer med sikkerhed og overholdelse af angivne standarder.

Når du sletter agenter, fjerner du dem fra dit miljø. Skabere og tidligere brugere kan ikke længere se dem.

Når du sletter en agent, der har en Microsoft Entra-agent-id, fjernes det tilknyttede agent-id (eller appregistrering for ældre agenter) også fra Microsoft Entra ID. Du kan få flere oplysninger under Automatisk oprettelse af Microsoft Entra agentidentiteter.

Vigtigt

Navnerummet powervirtualgents er forældet. Brug copilotstudio navnerummet i dine API-kald.

Forudsætninger

• Du har Robot-id og miljø-id for målagenten.
• Du skal hente et brugeradgangstoken, der er udstedt af Microsoft Entra ID OAuth2. Hvis du vil hente et token, skal du se Godkendelse.
  • Brugeren, der er tilknyttet tokenet, skal have en af følgende admin-roller:
    • Global lejeradministrator
    • AI-administrator
    • Power Platform-administrator
  • Du skal hente adgangstokenet ved hjælp af klient-id'et for en appregistrering, der har området CopilotStudio.AdminActions.Invoke tildelt under Power Platform-API'en.

API-handlinger til sletning af agent

Copilot Studio som en del af Power Platform-API'en understøtter HANDLINGEN REST API delete til fjernelse af agenter.

Du kan få flere oplysninger om, hvordan og hvornår du skal bruge Power Platform-API'en, under:

• Power Platform API og SDK'er: Fra UX-first til API-first (Blog) (Power Platform Developer Blog)
• Oversigt over programmering og udvidelse (Power Platform-dokumentation)
• Kom i gang med Power Platform API (Power Platform-dokumentation)
• Power Platform API-operationsreferencedokumentation

Slet agent

• Slutpunkt: DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
• Formål: Permanent slette en agent
• Svar: Returneres 204 OK , hvis agenten blev slettet med succes

Få mere at vide i Delete Copilot Agent API-referencedokumentation.