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

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

Het in quarantaine plaatsen van agenten maakt deel uit van het bredere beveiligingsframework van Copilot Studio en werkt samen met uw algemene beveiligingsaanpak in Copilot Studio.

Agents die het gegevensbeleid schenden of geen nalevingsdocumentatie hebben kunnen bijvoorbeeld worden gemarkeerd als onderdeel van audits, runtime-beveiliging 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.

Agentgebruikers en -makers kunnen nog steeds agents in quarantaine zien in Copilot Studio . Makers kunnen tijdens het testen met de agenten werken, maar ze kunnen niet werken met agenten in quarantaine in andere kanalen.

Belangrijk

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

Vereisten

  • U hebt de bot- en omgevings-id voor de doelagent.
  • U moet een gebruikerstoegangstoken verkrijgen die is uitgegeven door Microsoft Entra ID OAuth2. Om een token te verkrijgen, zie Verificatie.
    • De gebruiker die aan het token is gekoppeld, moet een van de volgende beheerdersrollen hebben:
      • Algemene tenantbeheerder
      • AI-beheerder
      • Power Platform-beheerder
    • U moet het toegangstoken verkrijgen met behulp van de client-ID van een app-registratie waaraan de CopilotStudio.AdminActions.Invoke-scope 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.

Notitie

De API's SetAsQuarantined en SetAsUnquarantined ondersteunen geen klassieke chatbots. De API retourneert 405 Method Not Allowed wanneer u een klassieke chatbot in quarantaine probeert te plaatsen of de quarantaine probeert op te heffen.

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: De huidige quarantainestatus van een agent ophalen
  • Reactie: Retourneert een boolean isBotQuarantined en lastUpdateTimeUtc

Lees meer in de API-referentiedocumentatie Get Bot Quarantine Status.

Agent instellen als in quarantaine geplaatst

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

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

Agent instellen als uit quarantaine gehaald

  • Eindpunt: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Doel: Haal een agent uit quarantaine na risicobeoordeling en herstel
  • Respons: bevestigt de update van de quarantainestatus

Meer informatie vindt u in Bot instellen als niet in quarantaine geplaatste API-referentiedocumentatie.

  • Last updated on