Sett ikke-kompatible agenter i karantene med Power Platform API

Copilot Studio gir administratorer robuste verktøy for å håndtere agentsikkerhet og etterlevelse, inkludert karantenetiltak for agenter gjennom Power Platform API.

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

For eksempel kan agenter som bryter dataretningslinjer eller mangler samsvarsdokumentasjon bli flagget som en del av revisjoner, kjøretidsbeskyttelse eller andre admin-rapporter 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 i karantene er fortsatt synlige for agentbrukere og skapere 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.

Forutsetninger

  • Du har bot-ID-en og miljø-ID-en for målagenten.
  • Du må skaffe deg en brukertilgangstoken utstedt av Microsoft Entra ID OAuth2. Hvis du vil ha et token, kan du se Godkjenning.
    • Brukeren tilknyttet tokenet må ha en av følgende administratorroller:
      • Global leietaker-administrator
      • AI-administrator
      • Power Platform-administrator
    • Du må skaffe tilgangstoken ved å bruke klient-ID-en til en appregistrering som har CopilotStudio.AdminActions.Invoke-omfanget gitt under Power Platform API.

API-operasjoner for håndtering av agentkarantene

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

Bemerkning

SetAsQuarantined og SetAsUnquarantined API-er støtter ikke klassiske chatboter. API-en returneres 405 Method Not Allowed når du prøver å sette en klassisk chatbot i karantene eller ukontenkning.

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

Få agentkarantenestatus

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

Lær mer i referansedokumentasjon for Get Bot Quarantine Status API.

Sett agenten i karantene

  • Endepunkt: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Formål: Merk en agent som i karantene, med begrensning av tilgjengelighet og interaksjoner
  • Svar: Bekrefter oppdatering av karantenestatus

Lær mer i referansedokumentasjon for Set Bot As Quarantined API.

Sett agent som fjernet fra karantene

  • Endepunkt: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Formål: Fjern et stoff fra karantene etter risikovurdering og opprydding
  • Svar: Bekrefter oppdatering av karantenestatus

Lær mer i referansedokumentasjon for Set Bot As Unquarantined API.

  • Last updated on