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 Studio laajempaa suojauskehystä ja työtä yhdessä yleisen suojausmenetelmäsi kanssa kohteessa Copilot Studio.

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.

Edellytykset

• 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 Platformin 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.