Slette agenter programmatisk ved hjelp av Power Platform API

Copilot Studio gir administratorer robustverktøy for å administrere agentsikkerhet og -samsvar, inkludert muligheten til å slette agenter gjennom Power Platform API.

Sletting av agenter er en del av Copilot Studio bredere sikkerhetsrammeverk og arbeid sammen med den generelle sikkerhetstilnærmingen i Copilot Studio.

Overvåkinger, kjøretidsbeskyttelse og andre administratorrapporter eller varsler kan for eksempel flagge agenter som bryter organisasjonens krav til sikkerhet og godkjenning. Administratorer kan bruke delete operasjonen til å fjerne ikke-kompatilede agenter mens de undersøker og utbedrer sikkerhets- og samsvarsproblemer.

Når du sletter agenter, fjerner du dem fra miljøet. Skapere og tidligere brukere kan ikke lenger se dem.

Når du sletter en agent som har en Microsoft Entra Agent ID, fjernes også den tilknyttede agent-ID-en (eller appregistreringen for eldre agenter) fra Microsoft Entra ID. Hvis du vil ha mer informasjon, kan du se Opprette Microsoft Entra agentidentiteter automatisk.

Forutsetning

• Du har bot-ID-en og miljø-ID-en for målagenten.
• Du må få et brukertilgangstoken utstedt av Microsoft Entra ID OAuth2. Hvis du vil ha et token, kan du se Godkjenning.
  • Brukeren tilknyttet tokenet må ha en av følgende administratorroller:
    • Global leietaker-administrator
    • KI-administrator
    • Power Platform-administrator
  • Du må skaffe tilgangstokenet ved hjelp av klient-ID-en for en appregistrering som har CopilotStudio.AdminActions.Invoke-omfanget gitt under Power Platform-API-en.

API-operasjoner for sletting av agenter

Copilot Studio, som en del av API-en for Power Platform, støtter REST-API-en delete operasjon for fjerning av agenter.

Hvis du vil ha mer informasjon om hvordan og når du skal bruke API-en for Power Platform, kan du se:

• Power Platform API og SDK-er: Fra UX-først til API-først (blogg) (Power Platform-utviklerblogg)
• Oversikt over programmerbarhet og utvidbarhet (Power Platform-dokumentasjon)
• Kom i gang med Power Platform API (Power Platform-dokumentasjon)
• Dokumentasjon for Power Platform API-operasjonsreferanser

Slett agent

• Endepunkt: 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 ble slettet med suksess

Finn ut mer i Slett Copilot referansedokumentasjon for agent-API.