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

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

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

For eksempel kan agenter, der overtræder datapolitikker eller mangler compliance-dokumentation , blive markeret som en del af revisioner, runtime-beskyttelse eller andre admin-rapporter eller notifikationer. Administratorer kan derefter bruge karantæne-API'erne til at isolere de agenter, der ikke overholder angivne standarder, samtidig med at de undersøger og afhjælper problemer med sikkerhed og overholdelse af angivne standarder.

Agenter, der er i karantæne, er stadig synlige for agentbrugere og -skabere i Copilot Studio, men det er ikke muligt at interagere med eller bruge agenten.

Vigtig

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

Forudsætninger

  • Du har bot-id'et og miljø-id'et for målagenten.
  • Du skal hente et brugeradgangstoken, der er udstedt af Microsoft Entra ID OAuth2. Hvis du vil hente et token, skal du se Godkendelse.
    • Brugeren, der er tilknyttet tokenet, skal have en af følgende admin-roller:
      • Global lejeradministrator
      • AI-administrator
      • Power Platform-administrator
    • Du skal skaffe adgangstoken ved hjælp af klient-ID'et for en app-registrering, der har CopilotStudio.AdminActions.Invoke-scopet , som er givet 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.

Note

Api'erne SetAsQuarantined og SetAsUnquarantined understøtter ikke klassiske chatbots. API'en returnerer 405 Method Not Allowed , når du forsøger at sætte en klassisk chatrobot i karantæne eller fjerne den fra karantæne.

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

Hent agentens karantænestatus

  • 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 referencedokumentationen for Get Bot Quarantine Status API.

Sæt agent i karantæne

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

Lær mere i referencedokumentationen Set Bot As Quarantined 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 et stof fra karantæne efter risikovurdering og afhjælpning
  • Svar: Bekræfter opdatering af karantænestatus

Lær mere i referencedokumentationen Set Bot As Unquarantined API.

  • Last updated on