Placera icke-kompatibla agenter i karantän med Power Platform-API:et

Copilot Studio ger administratörer robusta verktyg för att hantera agentsäkerhet och efterlevnad, inklusive karantänåtgärder för agenter via Power Platform API.

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

Till exempel kan agenter som bryter mot datapolicys eller saknar efterlevnadsdokumentation flaggas som en del av revisioner, körtidsskydd eller andra administratörsrapporter eller notifikationer. Administratörer kan sedan använda karantän-API:erna för att isolera de icke kompatibla agenterna medan de utreder och åtgärdar säkerhets- och regelefterlevnadsproblem.

Agenter som är i karantän är fortfarande synliga för agentanvändare och skapare i Copilot Studio, men det är inte möjligt att interagera med eller använda agenten.

Important

Namnrymden powervirtualgents är föråldrad. Använd copilotstudio namnrymden i dina API-anrop.

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 skaffa en access-token genom att använda klient-ID:t för en appregistrering där CopilotStudio.AdminActions.Invoke-området har beviljats under Power Platform API.

API-åtgärder för agentens karantänhantering

Copilot Studio stöder tre viktiga REST API-åtgärder för att hantera agentens karantän som en del av Power Platform-API:et.

Note

Api:erna SetAsQuarantined och SetAsUnquarantined stöder inte klassiska chattrobotar. API:et returnerar 405 Method Not Allowed när du försöker sätta en klassisk bot i karantän eller ta bort karantän.

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

Hämta karantänstatus för agent

  • Slutpunkt:GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Syfte: Hämta den aktuella karantänstatusen för en agent
  • Svar: Returnerar en boolean och isBotQuarantinedlastUpdateTimeUtc

Läs mer i referensdokumentationen för Get Bot Quarantine Status API.

Ange agent som i karantän

  • Slutpunkt:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Syfte: Markera en agent som i karantän, vilket begränsar dess tillgänglighet och interaktioner
  • Svar: Bekräftar uppdatering av karantänstatusen

Läs mer i referensdokumentationen Set Bot As Quarantined API.

Ange agent som ur karantän

  • Slutpunkt:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Syfte: Ta bort ett medel från karantän efter riskbedömning och åtgärd
  • Svar: Bekräftar uppdatering av karantänstatusen

Läs mer i Set Bot As Unquarantined API-referensdokumentationen.

  • Last updated on