Sæt ikke-kompatible agenter i karantæne med Power Platform-API'en

Copilot Studio giver administratorer robuste værktøjer til at administrere agentsikkerhed og -overholdelse, herunder karantænehandlinger for agenter via Power Platform-API.

Karantæne af agenter er en del af Copilot Studios bredere sikkerhedsstruktur og fungerer sammen med din overordnede sikkerhedstilgang i Copilot Studio.

Agenter, der f.eks. overtræder datapolitikker eller mangler dokumentation til overholdelse af angivne standarder, kan f.eks. markeres som en del af overvågning, kørselsbeskyttelse eller andre administratorrapporter eller meddelelser. Administratorer kan derefter bruge karantæne-API til at isolere de agenter, der ikke overholder angivne standarder, mens de undersøger og afhjælper problemer med sikkerhed og overholdelse af angivne standarder.

Agenter, der er sat i karantæne, vil stadig være synlige for agentbrugere og udviklere i Copilot Studio, men de kan ikke interagere med eller bruge agenten.

Vigtigt

powervirtualgents navnerummet er forældet. Brug copilotstudio navnerummet i dine API-kald.

Forudsætninger

  • Du har Robot-id og miljø-id for målagenten.
  • Du skal indhente en brugeradgangstoken udstedt af Microsoft Entra ID OAuth2. For at indhente et token, se Autentificering.
    • Den bruger, der er tilknyttet tokenet, skal have en af følgende administratorroller:
      • Global lejeradministrator
      • AI-administrator
      • Power Platform-administrator
    • Du skal anskaffe adgangstoken ved brug af klient-ID'et for en registreret app, der har CopilotStudio.AdminActions.Invoke omfang tildelt under Power Platform API'en.

API-handlinger til administration af agentkarantæne

Copilot Studio understøtter tre vigtige REST API-handlinger til administration af agentkarantæne som en del af Power Platform-API'en.

Bemærk

API'erne SetAsQuarantined og SetAsUnquarantined understøtter ikke klassiske chatrobotter. API'et returnerer 405 Method Not Allowed, når du forsøger at sætte en klassisk chatrobot i karantæne eller ophæve dens karantænestatus.

Du kan få flere oplysninger om, hvordan og hvornår du skal bruge Power Platform-API, under:

Hent status for agentkarantæne

  • Slutpunkt: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Formål: Hent den aktuelle karantænestatus for en agent
  • Svar: Returnerer en boolesk isBotQuarantined og lastUpdateTimeUtc

Læs mere i referencedokumentation for Hent status for robotkarantæne-API.

Angiv agent som sat i karantæne

  • Slutpunkt: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Formål: Markér en agent som sat i karantæne, så dens tilgængelighed og interaktioner begrænses
  • Svar: Bekræfter opdateringen af karantænestatus

Læs mere i referencedokumentationen for Angiv robot som sat i karantæne-API.

Angiv agent som ikke er sat i karantæne

  • Slutpunkt: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Formål: Fjern en agent fra karantæne efter risikovurdering og afhjælpning
  • Svar: Bekræfter opdateringen af karantænestatus

Læs mere i Angiv robot som ikke sat i karantæne-API-referencedokumentationen.

  • Last updated on