Vaatimustenvastaisten agenttien asettaminen karanteeniin Power Platform -ohjelmointirajapinnan avulla

Copilot Studio tarjoaa järjestelmänvalvojille robust-työkaluja agenttien suojauksen ja vaatimustenmukaisuuden hallintaan mukaan lukien agenttien karanteenitoiminnot Power Platform API:n kautta.

Näennäisagentit ovat osa Copilot Studion laajempaa turvallisuuskehystä ja työtä yhdessä yleisen suojausmenetelmäsi kanssa Copilot Studio:ssä.

Esimerkiksi agentit, jotka rikkovat datakäytäntöjä tai joilla ei ole vaatimustenmukaisuutta, voidaan merkitä osaksi auditointeja, ajonaikaista suojausta tai muita ylläpitäjäraportteja tai ilmoituksia. Järjestelmänvalvojat voivat eristää vaatimustenvastaisset agentit karanteeniohjelmointirajapintojen avulla samalla, kun suojauksen ja vaatimustenmukaisuuden ongelmia tutkitaan ja korjataan.

Karanteenissa olevat agentit näkyvät edelleen agenttikäyttäjille ja tekijöille Copilot Studiossa, mutta agenttia ei voi käsitellä tai käyttää.

Tärkeä

Nimiavaruus powervirtualgents on vanhentunut. Käytä API-kutsujen copilotstudio nimiavaruutta.

Edellytykset

• Sinulla on kohdeagentin Bot-tunnus ja Ympäristötunnus.
• Tarvitset käyttäjän käyttöoikeustietueen, jonka on myöntänyt Microsoft Entra ID OAuth2. Jos haluat tunnuksen, katso Todentaminen.
  • Tokeniin liitetyllä käyttäjällä tulee olla jokin seuraavista ylläpitäjän rooleista:
    • Globaali vuokralaishallinnon virkailija
    • Tekoälyn järjestelmänvalvoja
    • Power Platformin järjestelmänvalvoja
  • Sinun on hankittava access -tunnus sovelluksen rekisteröinnin asiakastunnuksella, jonka CopilotStudio.AdminActions.Invoke -laajuus on myönnetty Power Platform -ohjelmointirajapinnassa.

Agentin karanteenin hallinnan ohjelmointirajapinnan toiminnot

Copilot Studio tukee kolmea tärkeää REST-ohjelmointirajapinnan toimintoa agentti karanteenin hallintaan osana Power Platform -ohjelmointirajapintaa.

Note

SetAsQuarantined- ja SetAsUnquarantined-ohjelmointirajapinnat eivät tue perinteisiä chatboteja. Ohjelmointirajapinta palauttaa arvon 405 Method Not Allowed , kun yrität asettaa perinteisen chatbotin karanteeniin tai purkaa sen.

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

• Power Platform -ohjelmointirajapinta ja SDK:t: UX-firstistä API-firstiin (blogi) (Power Platform Developer Blog)
• Ohjelmoitavuuden ja laajennettavuuden yleiskatsaus (Power Platform -dokumentaatio)
• Aloita Power Platform API :n (Power Platform -dokumentaatio) kanssa
• Power Platform API -toimintojen viitedokumentaatio

Agentin karanteenitilan hakeminen

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

Lue lisää Get Bot Quarantine Status API -viitedokumentaatiosta.

Agentin asettaminen karanteeniin

• Päätepiste: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
• Tarkoitus: Merkitse agentti karanteeniin, rajoittaen sen saatavuutta ja vuorovaikutusta
• Vastaus: Vahvistaa karanteenitilan päivityksen

Lue lisää Set Bot As Quarantined API -viitedokumentaatiosta.

Agentin poistaminen karanteenista

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

Lue lisää Set Bot As Unquarantined API -viitedokumentaatiosta.