Ta bort agenter programmatiskt med hjälp av Power Platform-API:et

Copilot Studio ger administratörer robust-verktyg för att hantera agentsäkerhet och efterlevnad, inklusive möjligheten att ta bort agenter via api:et Power Platform.

Att ta bort agenter är en del av Copilot Studios bredare säkerhetsramverk och fungerar tillsammans med din övergripande säkerhetsstrategi i Copilot Studio.

Till exempel kan granskningar, körningsskydd och andra administratörsrapporter eller meddelanden flagga agenter som bryter mot organisationens krav på säkerhet och autentisering. Administratörer kan använda åtgärden delete för att ta bort icke-kompatibla agenter när de undersöker och åtgärdar säkerhets- och efterlevnadsproblem.

När du tar bort agenter tar du bort dem från din miljö. Skapare och tidigare användare kan inte längre se dem.

När du tar bort en agent som har en Microsoft Entra agent-ID tas även det associerade agent-ID:t (eller appregistreringen för äldre agenter) bort från Microsoft Entra ID. Mer information finns i Automatiskt skapa Microsoft Entra agentidentiteter.

Förutsättningar

• Du har robot-ID och miljö-ID för målagenten.
• Du måste skaffa en användaråtkomsttoken utfärdad av Microsoft Entra ID OAuth2. Information om hur du hämtar en token finns i Autentisering.
  • Användaren som är kopplad till token måste ha en av följande administratörsroller:
    • Global hyresgästadministratör
    • AI-administratör
    • Power Platform-administratör
  • Du måste hämta åtkomsttoken med hjälp av klient-ID:t för en appregistrering som har CopilotStudio.AdminActions.Invoke-omfånget beviljat under Power Platform-API:et.

API-åtgärder för borttagning av agent

Copilot Studio, som en del av Power Platform API, stöder REST API delete åtgärd för att ta bort agenter.

Mer information om hur och när du ska använda Power Platform-API:et finns i:

• Power Platform API och SDK:er: Från UX-first till API-first (blogg) (Power Platform-utvecklarblogg)
• Översikt över programmering och utökningsbarhet (Power Platform-dokumentation)
• Kom igång med Power Platform API (Dokumentation om Power Platform)
• Dokumentation för Power Platform API-operationer

Ta bort agent

• Slutpunkt:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
• Syfte: Att permanent ta bort en agent
• Svar: Returnerar 204 OK om agenten raderades framgångsrikt

Läs mer i referensdokumentationen Delete Copilot Agent API.