Vaatimustenvastaisten agenttien asettaminen karanteeniin Power Platform -ohjelmointirajapinnan avulla

Copilot Studio antaa järjestelmänvalvojille vakaat työkalut agentin suojauksen ja vaatimustenmukaisuuden hallintaan, mukaan lukien agentteja koskevat karanteenitoiminnot Power Platform -ohjelmointirajapinnan kautta.

Agenttien asettaminen karanteeniin on osa Copilot Studion suojauskehikkoa ja se toimii yhdessä Copilot Studion yleisen suojauksen kanssa.

Esimerkiksi tietokäytäntöjä rikkovat agentit tai agentit, joista vaatimustenmukaisuusdokumentaatio puuttuu, voidaan merkitä seuranta- tai suorituspalvelun suojausraporttien tai -ilmoitusten taikka muiden hallintaraporttien tai -ilmoitusten osana. Järjestelmänvalvojat voivat eristää vaatimustenvastaisset agentit karanteeniohjelmointirajapintojen avulla samalla, kun suojauksen ja vaatimustenmukaisuuden ongelmia tutkitaan ja korjataan.

Agentin käyttäjät ja tekijät Copilot Studiossa näkevät edelleen karanteeniin asetetut agentit, mutta he eivät voi käyttää agenttia.

Tärkeää

Nimiavaruus powervirtualgents on vanhentunut. Käytä nimiavaruutta copilotstudio ohjelmointirajapintakutsuissa.

Edellytykset

  • Kohdeagentin botin tunnus ja ympäristön tunnus.
  • Sinun on hankittava Microsoft Entra ID OAuth2:n myöntämä käyttäjän käyttöoikeustietue. Katso lisätietoja tietueen hankkimisesta kohdasta Todentaminen.
    • Tietueeseen liittyvällä käyttäjällä tulee olla jokin seuraavista järjestelmänvalvojan rooleista:
      • Vuokraajan yleinen järjestelmänvalvoja
      • Tekoälyn järjestelmänvalvoja
      • Power Platformin järjestelmänvalvoja
    • Käyttöoikeustietue on hankittava käyttämällä sovellusrekisteröinnin asiakastunnusta, jolle on myönnetty CopilotStudio.AdminActions.Invoke-vaikutusalue Power Platform -ohjelmointirajapinnassa.

Agentin karanteenin hallinnan ohjelmointirajapinnan toiminnot

Copilot Studio tukee kolmea keskeistä agentin karanteenin hallintaan käytettyä REST API -toimintoa Power Platform -ohjelmointirajapinnan osana.

Muistiinpano

SetAsQuarantined- ja SetAsUnquarantined-ohjelmointirajapinnat eivät tue perinteisiä keskustelubotteja. Ohjelmointirajapinta palauttaa 405 Method Not Allowed, kun yrität asettaa perinteisen keskustelubotin karanteeniin tai poistaa sen karanteenista.

Lisätietoja Power Platform -ohjelmointirajapinnan käyttötavasta ja -ajankohdasta:

Agentin karanteenitilan hakeminen

  • Päätepiste: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Tarkoitus: agentin nykyisen karanteenitilan noutaminen
  • Vastaus: palauttaa totuusarvon isBotQuarantined ja lastUpdateTimeUtc

Lisätietoja on kohdassa Botin karanteenitilan hakemisen ohjelmointirajapinnan viitedokumentaatioon.

Agentin asettaminen karanteeniin

  • Päätepiste: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Tarkoitus: agentin merkitseminen karanteeniin asetetuksi, mikä rajoittaa sen saatavuutta ja käyttöä
  • Vastaus: vahvistaa karanteenitilan päivityksen

Lisätietoja on kohdassa Botin karanteenitilan määrittämisen ohjelmointirajapinnan viitedokumentaatioon

Agentin poistaminen karanteenista

  • Päätepiste: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Tarkoitus: agentin poistaminen karanteenista riskinarvioinnin ja korjauksen jälkeen
  • Vastaus: vahvistaa karanteenitilan päivityksen

Lisätietoja on kohdassa Botin karanteenista poistamisen ohjelmointirajapinnan viitedokumentaatioon

  • Last updated on