Niet-conforme agenten in quarantaine plaatsen met de Power Platform-API

Copilot Studio biedt beheerders robuuste tools om agentbeveiliging en naleving te beheren, inclusief quarantaineacties voor agenten via de Power Platform API.

Het in quarantaine stellen van agenten maakt deel uit van het bredere beveiligingskader van Copilot Studio en werkt samen met je algehele beveiligingsaanpak in Copilot Studio.

Agenten die bijvoorbeeld databeleid overtreden of geen compliance-documentatie hebben, kunnen worden gemarkeerd als onderdeel van audits, runtime-bescherming of andere beheerdersrapporten of meldingen. Beheerders kunnen vervolgens de quarantaine-API's gebruiken om de niet-conforme agenten te isoleren tijdens het onderzoeken en oplossen van beveiligings- en nalevingsproblemen.

Agenten die in quarantaine staan, zijn nog steeds zichtbaar voor agentgebruikers en makers in Copilot Studio, maar het is niet mogelijk om met de agent te interageren of ze te gebruiken.

Important

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

Vereiste voorwaarden

  • 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
    • Je moet het toegangstoken verkrijgen met behulp van de client-ID van een app-registratie die de CopilotStudio.AdminActions.Invoke-scope bevat die is toegekend onder de Power Platform API.

API-bewerkingen voor agentquarantainebeheer

Copilot Studio ondersteunt drie belangrijke REST API-bewerkingen voor het beheren van agentquarantaines, als onderdeel van de Power Platform-API.

Note

De SetAsQuarantined - en SetAsUnquarantined API's bieden geen ondersteuning voor klassieke chatbots. De API retourneert 405 Method Not Allowed wanneer u probeert een klassieke chatbot in quarantaine te plaatsen of te dequarantine opheffen.

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

Quarantainestatus van agent ophalen

  • Eindpunt:GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Doel: Haal de huidige quarantainestatus van een agent op
  • Antwoord: Geeft een booleaan isBotQuarantined terug en lastUpdateTimeUtc

Lees meer in de referentiedocumentatie Get Bot Quarantine Status API.

Agent in quarantaine plaatsen

  • Eindpunt:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Doel: Een agent als in quarantaine markeren, waardoor de beschikbaarheid en interacties beperkt worden
  • Reactie: Bevestigt quarantainestatusupdate

Lees meer in de referentiedocumentatie van Set Bot As Quarantined API.

Agent uit quarantaine halen

  • Eindpunt:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Doel: Verwijder een agent uit quarantaine na risicobeoordeling en remediëring
  • Reactie: Bevestigt quarantainestatusupdate

Lees meer in de referentiedocumentatie van Set Bot As Unquarantined API.

  • Last updated on