Sett ikke-kompatible agenter i karantene med Power Platform API

Microsoft Copilot Studio gir administratorer Robuste verktøy for å administrere agentsikkerhet og samsvar, inkludert karantenetiltak for agenter gjennom Power Platform API.

Karantene-agenter er en del av Copilot Studios bredere sikkerhetsrammeverk, og fungerer sammen med din overordnede sikkerhetstilnærming i Copilot Studio.

For eksempel agenter som bryter datapolicyer eller manglende samsvarsdokumentasjon kan rapporteres som en del av revisjoner, kjøretidsbeskyttelse eller andre administratorrapporter eller varsler. Administratorer kan deretter bruke karantene-API-ene til å isolere de ikke-kompatible agentene mens de undersøker og utbedrer sikkerhets- og samsvarsproblemer.

Agenter som er satt i karantene, er fortsatt synlige for agentbrukere og utviklere i Copilot Studio, men det er ikke mulig å samhandle med eller bruke agenten.

Viktig!

Navnerommet powervirtualgents er foreldet. Bruk copilotstudio navnerommet i API-kallene dine.

Forutsetning

  • Du har bot-ID-en og miljø-ID-en for målagenten.
  • Du må innhente et bruker-tilgangstoken utstedt av Microsoft Entra ID OAuth2. For å skaffe et token, se Autentisering.
    • Brukeren tilknyttet tokenet må ha en av følgende administratorroller:
      • Global-leieradministrator
      • KI-administrator
      • Power Platform-administrator
    • Du må hente tilgangstokenet ved å bruke klient-ID-en til en appregistrering som har CopilotStudio.AdminActions.Invoke-omfanget tildelt under Power Platform API.

API-operasjoner for håndtering av agentkarantene

Copilot Studio støtter tre viktige REST API-operasjoner for å administrere agentkarantene, som en del av Power Platform API.

Notat

SetAsQuarantined- og SetAsUnquarantined-API-ene støtter ikke klassiske chatroboter. API-en returnerer 405 Method Not Allowed når du prøver å sette en klassisk chatrobot i karantene eller fjerne den fra karantene.

Hvis du vil ha mer informasjon om hvordan og når du skal bruke Power Platform API, kan du se:

Få agentkarantenestatus

  • Endepunkt: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Formål: Hente gjeldende karantenestatus for en agent
  • Svar: Returnerer en boolsk verdi isBotQuarantined og lastUpdateTimeUtc

Les mer i referansedokumentasjonen for Hent API for robotkarantenestatus.

Sett agenten i karantene

  • Endepunkt: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Formål: Markere en agent som satt i karantene, og begrense tilgjengeligheten og samhandlingene
  • Svar: Bekrefter oppdatering av karantenestatus

Les mer i referansedokumentasjonen for Angi API for robot som satt i karantene.

Sett agenten som ikke i karantene

  • Endepunkt: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Formål: Fjerne en agens fra karantenen etter risikovurdering og utbedring
  • Svar: Bekrefter oppdatering av karantenestatus

Les mer i referansedokumentasjonen for Angi API for robot som tatt ut av karantene.

  • Last updated on