Määritä orvoiksi jääneiden agenttien omistajuus uudelleen Power Platform API:n avulla

Copilot Studio antaa järjestelmänvalvojille vakaat työkalut agentin suojauksen ja vaatimustenmukaisuuden hallintaan, mukaan lukien mahdollisuus määrittää orpojen agenttien omistajuus uudelleen Power Platform -ohjelmointirajapinnan kautta.

Orpojen agenttien omistajuuden uudelleenmääritys on osa Copilot Studion suojauskehystä ja se toimii yhdessä Copilot Studion yleisen suojauksen kanssa.

Esimerkiksi, kun agentin alkuperäinen omistaja poistuu organisaatiosta tai vaihtaa roolia, tämä voi johtaa orvoksi jääneisiin agentteihin, joilta puuttuu asianmukainen hallinta. Tämä tilanne voi häiritä liiketoimintaprosesseja ja luoda tietoturvariskejä, koska agentin asetuksia ja vaatimustenmukaisuusvaatimuksia ei välttämättä ole kenenkään vastuulla. Ylläpitäjät voivat käyttää Määritä uudelleen API:a siirtääkseen orpojen agenttien omistajuuden varmistaakseen, että ne pysyvät asianmukaisesti hallinnassa ja vaatimustenmukaisina.

Copilot Studion agenttikäyttäjät ja kehittäjät voivat nähdä agentit, joiden omistajuus on siirretty. Uusi omistaja saa ympäristön tekijän oikeudet agentin ympäristöön. Vanha omistaja menettää pääsyn agenttiin omistajuuden siirron jälkeen. Agentin omistajuuden siirron jälkeen, jos uudella omistajalla on Lue transkriptio -oikeus, hän saa käyttöön kaikki agentin olemassa olevat transkriptiot.

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.
    • Copilot Studiossa luodun agentin omistajan uudelleenmäärittämiseksi tunnukseen liitetyllä käyttäjällä on oltava jokin seuraavista ylläpitäjärooleista:
      • Vuokraajan yleinen järjestelmänvalvoja
      • Tekoälyn järjestelmänvalvoja
      • Power Platformin järjestelmänvalvoja
      • Ympäristön järjestelmänvalvoja
    • Agentin muodostintyökalussa luodun agentin omistajan uudelleenmäärittämiseksi tunnukseen liitetyllä käyttäjällä on oltava jokin seuraavista ylläpitäjä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.
  • Sinulla on uuden omistajan Entra-käyttäjätunnus, jolle agentin omistus tulee siirtää.
  • Uuden omistajan täytyy olla vuokraajan jäsen.

API-toiminnot agentin omistajuuden uudelleenmäärittämiseksi

Copilot Studio tukee REST API -reassign-toimintoa orpojen agenttien uudelleenmäärittämiseen uusille omistajille osana Power Platform -ohjelmointirajapintaa.

Muistiinpano

Määritä uudelleen -API ei tue klassisia keskustelubotteja. API palauttaa 405 Method Not Allowed -komennon, kun yrität siirtää omistajuuden klassiselle keskustelubotille.

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

Agentin omistajuuden siirtäminen uudelle omistajalle

  • Päätepiste: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations/reassign?api-version=1

  • Teksti: {"NewOwnerAadUserId": "EntraUserId"}

    Korvaa EntraUserId uuden omistajan Entra-käyttäjätunnuksella.

  • Tarkoitus: agentin omistajan vaihtaminen

  • Vastaus: Ei sisältöä

  • Last updated on