Agenttien ohjelmallinen poistaminen Power Platform -ohjelmointirajapinnan avulla

Copilot Studio tarjoaa järjestelmänvalvojille robust-työkaluja agenttien suojauksen ja yhteensopivuuden hallintaan muun muassa agenttien poistamiseen Power Platform -ohjelmointirajapinnan kautta.

Agenttien poistaminen on osa Copilot Studion laajempaa suojauskehystä ja työtä yhdessä yleisen suojausmenetelmäsi kanssa Copilot Studio:ssä.

Esimerkiksi tarkastukset, suorituksenaikainen suojaus ja muut järjestelmänvalvojan raportit tai ilmoitukset voivat merkitä agentteja, jotka rikkovat suojauksen ja todentamisen organisaation vaatimuksia. Järjestelmänvalvojat voivat -toiminnon avulla delete poistaa yhteensopimattomia agentteja tutkiessaan ja korjatakseen suojaus- ja yhteensopivuusongelmia.

Kun poistat agentteja, poistat ne ympäristöstäsi. Tekijät ja aiemmat käyttäjät eivät enää näe niitä.

Kun poistat agentin, jolla on Microsoft Entra -agenttitunnus, myös siihen liittyvä agenttitunnus (tai vanhojen agenttien sovelluksen rekisteröinti) poistetaan Microsoft Entra ID. Lisätietoja on kohdassa Luo Microsoft Entra agentin käyttäjätiedot automaattisesti.

Vaatimukset

• Sinulla on kohdeagentin botin tunnus ja ympäristön 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 Platform -järjestelmänvalvoja
  • Sinun on hankittava käyttöoikeustietue käyttämällä sovelluksen rekisteröinnin asiakastunnusta, jolla on CopilotStudio.AdminActions.Invoke-laajuus , joka on myönnetty Power Platform -ohjelmointirajapinnassa.

Agentin poistoa koskevat ohjelmointirajapinnan toiminnot

Copilot Studio tukee osana Power Platform -ohjelmointirajapintaa REST-ohjelmointirajapinnan delete-toimintoa agenttien poistamiseksi.

Lisätietoja Siitä, milloin ja miten Power Platform -ohjelmointirajapintaa käytetään, on seuraavissa ohjeissa:

• 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 poistaminen

• Päätepiste: DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
• Tarkoitus: Poista agentti pysyvästi
• Vastaus: Palauttaa 204 OK , jos agentti poistettiin onnistuneesti

Lisätietoja on Delete Copilot Agent API -viitedokumentaatiossa.