Omfordele ejerskabet af forældreløse agenter med Power Platform API'en

Copilot Studio giver administratorer robuste værktøjer til at håndtere bot-sikkerhed og compliance, herunder muligheden for at omfordele ejerskab af forældreløse agenter via Power Platform API'en.

Omfordeling af ejerskabet af forældreløse agenter er en del af Copilot Studios bredere sikkerhedsrammeværk og arbejder sammen med din overordnede sikkerhedstilgang i Copilot Studio.

For eksempel, når den oprindelige ejer af en agent forlader organisationen eller skifter rolle, kan det føre til forældreløse agenter, der mangler ordentlig ledelse. Denne situation kan forstyrre forretningsprocesser og skabe sikkerhedsrisici, da der måske ikke er en ansvarlig part til at håndtere agentens indstillinger og overholdelseskrav. Administratorer kan bruge Reassign-API'en til at omfordele ejerskabet af disse forældreløse agenter for at sikre, at de forbliver korrekt administreret og i overensstemmelse med reglerne.

Agentbrugere og -skabere i Copilot Studio kan se agenter, der bliver omfordelt. Den nye ejer får miljøskaber-tilladelser til botens miljø. Den gamle ejer mister adgangen til agenten efter omplacering.

Vigtig

Navnerummet powervirtualgents er forældet. Brug copilotstudio navnerummet i dine API-kald.

Forudsætninger

  • Du har bot-id'et og miljø-id'et for målagenten.
  • Du skal hente et brugeradgangstoken, der er udstedt af Microsoft Entra ID OAuth2. Hvis du vil hente et token, skal du se Godkendelse.
    • Hvis du vil tildele ejeren af en agent, der er oprettet i Copilot Studio, skal den bruger, der er knyttet til tokenet, have en af følgende administratorroller:
      • Global lejeradministrator
      • AI-administrator
      • Power Platform-administrator
      • Miljøadministrator
    • For at omfordele ejeren af en agent oprettet i Agent Builder, skal brugeren, der er tilknyttet tokenet, have en af følgende admin-roller:
      • Global lejeradministrator
      • AI-administrator
      • Power Platform-administrator
    • Du skal skaffe adgangstoken ved hjælp af klient-ID'et for en app-registrering, der har CopilotStudio.AdminActions.Invoke-scopet , som er givet under Power Platform API'en.
  • Du har Entra-bruger-ID'et på den nye ejer, som ejerskabet af agenten skal overføres til.
  • Den nye ejer skal tilhøre lejeren.

API-operationer til omfordeling af agentejerskab

Copilot Studio understøtter REST API-operationen reassign til at omfordele forældreløse agenter til nye ejere som en del af Power Platform API'en.

Note

Omfordelings-API'en understøtter ikke klassiske chatbots. API'en returnerer 405 Method Not Allowed , når du forsøger at tildele ejerskabet af en klassisk chatrobot igen.

Du kan få flere oplysninger om, hvordan og hvornår du skal bruge Power Platform-API'en, under:

Omfordele ejerskabet af en agent til en ny ejer

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

  • Tekst:{"NewOwnerAadUserId": "EntraUserId"}

    Erstat EntraUserId med den nye ejers entra-bruger-ID.

  • Formål: Skift ejer af agenten

  • Svar: Intet indhold

  • Last updated on