Tildel eierskap på nytt for frittstående agenter med Power Platform-API

Copilot Studio gir administratorer robuste verktøy for å administrere agentsikkerhet og etterlevelse, inkludert muligheten til å tildele eierskap for frittstående agenter via Power Platform-API.

Ny tildeling av eierskap for frittstående agenter er en del av Copilot Studios bredere sikkerhetsrammeverk og fungerer sammen med din overordnede sikkerhetstilnærming i Copilot Studio.

Når den opprinnelige eieren av en agent for eksempel forlater organisasjonen eller bytter rolle, kan det føre til frittstående agenter som mangler riktig administrasjon. Denne situasjonen kan forstyrre forretningsprosesser og skape sikkerhetsrisikoer, siden det ikke nødvendigvis finnes en ansvarlig part som kan administrere agentens innstillinger og etterlevelseskrav. Administratorer kan bruke API-en Tilordne på nytt til å tildele eierskap av disse frittstående agentene på nytt for å sikre at de forblir riktig administrert og etterlever krav.

Agentbrukere og utviklere i Copilot Studio kan se agenter som blir tildelt på nytt. Den nye eieren får miljøutviklertillatelse i agentens miljø. Den gamle eieren mister tilgang til agenten etter den nye tildelingen. Hvis den nye eieren har rettigheten Lese utskrift etter at eierskapet til en agent er tildelt på nytt, kan den nye eieren få tilgang til alle eksisterende utskrifter for agenten.

Viktig!

Navnerommet powervirtualgents er foreldet. Bruk copilotstudio navnerommet i API-kallene dine.

Forutsetning

  • Du har bot-ID-en og miljø-ID-en for målagenten.
  • Du må innhente et bruker-tilgangstoken utstedt av Microsoft Entra ID OAuth2. For å skaffe et token, se Autentisering.
    • Hvis du vil tildele eieren av en agent opprettet i Copilot Studio på nytt, må brukeren som er tilknyttet tokenet, ha én av følgende administratorroller:
      • Global-leieradministrator
      • KI-administrator
      • Power Platform-administrator
      • Miljøadministrator
    • Hvis du vil tildele eierskapet for en agent opprettet i agentverktøyet på nytt, må brukeren som er knyttet til tokenet, ha én av følgende administratorroller:
      • Global-leieradministrator
      • KI-administrator
      • Power Platform-administrator
    • Du må hente tilgangstokenet ved å bruke klient-ID-en til en appregistrering som har CopilotStudio.AdminActions.Invoke-omfanget tildelt under Power Platform API.
  • Du har bruker-ID-en for Entra til den nye eieren som skal få tildelt eierskapet for agenten.
  • Den nye eieren må tilhøre leieren.

API-operasjoner for ny tildeling av agenteierskap

Copilot Studio støtter REST-API-operasjonen reassign for å tildele frittstående agenter på nytt til nye eiere, som en del Power Platform-API.

Notat

API-en Tildel på nytt støtter ikke klassiske chatroboter. API-en returnerer 405 Method Not Allowed når du prøver å tildele eierskapet på nytt for en klassisk chatrobot.

Hvis du vil ha mer informasjon om hvordan og når du skal bruke Power Platform API, kan du se:

Tildel et agenteierskap på nytt til en ny eier

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

  • Brødtekst: {"NewOwnerAadUserId": "EntraUserId"}

    Erstatt EntraUserId med bruker-ID-en for Entra til den nye eieren.

  • Formål: Endre eieren av agenten

  • Svar: Uten innhold

  • Last updated on