Herverdeel het eigendom van verweesde agenten met de Power Platform API

Copilot Studio biedt beheerders krachtige hulpprogramma's voor het beheren van botbeveiliging en -naleving, met inbegrip van de mogelijkheid om het eigendom van verweesde agents opnieuw toe te wijzen via de Power Platform-API.

Het opnieuw toewijzen van het eigendom van weesagenten maakt deel uit van het bredere beveiligingsframework van Copilot Studio en functioneert in samenhang met uw algehele beveiligingsbenadering in Copilot Studio.

Bijvoorbeeld, wanneer de oorspronkelijke eigenaar van een agent de organisatie verlaat of van rol verandert, kan dit leiden tot wees-agenten die geen goed beheer hebben. Deze situatie kan bedrijfsprocessen verstoren en beveiligingsrisico's creëren, omdat er mogelijk geen verantwoordelijke partij is om de instellingen en compliance-eisen van de agent te beheren. Beheerders kunnen de Reassign API gebruiken om het eigendom van deze verweesde agenten opnieuw toe te wijzen, zodat ze goed beheerd en compliant blijven.

Agentgebruikers en makers in Copilot Studio kunnen agenten zien die opnieuw worden toegewezen. De nieuwe eigenaar krijgt omgevingsmakerrechten voor de omgeving van de bot. De oude eigenaar verliest de toegang tot de agent na een herplaatsing.

Belangrijk

De powervirtualgents naamruimte is verouderd. Gebruik de copilotstudio naamruimte in je API-aanroepen.

Vereiste voorwaarden

  • U hebt de bot- en omgevings-ID voor de doelagent.
  • U moet een gebruikerstoegangstoken verkrijgen dat is uitgegeven door Microsoft Entra ID OAuth2. Zie Verificatie om een token te verkrijgen.
    • Als u de eigenaar van een agent die is gemaakt in Copilot Studio opnieuw wilt toewijzen, moet de gebruiker die is gekoppeld aan het token een van de volgende beheerdersrollen hebben:
      • Globale tenantbeheerder
      • AI-beheerder
      • Power Platform-beheerder
      • Omgevingsbeheerder
    • Om de eigenaar van een agent die in Agent Builder is aangemaakt opnieuw toe te wijzen, moet de gebruiker die aan het token gekoppeld is een van de volgende adminrollen hebben:
      • Globale tenantbeheerder
      • AI-beheerder
      • Power Platform-beheerder
    • Je moet het toegangstoken verkrijgen met behulp van de client-ID van een app-registratie die de CopilotStudio.AdminActions.Invoke-scope bevat die is toegekend onder de Power Platform API.
  • U heeft de Entra-gebruikers-ID van de nieuwe eigenaar aan wie het eigendom van de agent moet worden toegewezen.
  • De nieuwe eigenaar moet toebehoren aan de huurder.

API-operaties voor het hertoewijzen van eigendom van agenten.

Copilot Studio ondersteunt de REST API-operatie reassign voor het hertoewijzen van verweesde agenten aan nieuwe eigenaren, als onderdeel van de Power Platform API.

Opmerking

De API voor opnieuw toewijzen biedt geen ondersteuning voor klassieke chatbots. De API retourneert 405 Method Not Allowed wanneer u probeert het eigendom van een klassieke chatbot opnieuw toe te wijzen.

Zie voor meer informatie over hoe en wanneer de Power Platform-API moet worden gebruikt:

Wijs het eigendom van een agent toe aan een nieuwe eigenaar

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

  • Hoofdtekst: {"NewOwnerAadUserId": "EntraUserId"}

    Vervang EntraUserId het door het Entra-gebruikersnummer van de nieuwe eigenaar.

  • Doel: Verander de eigenaar van de makelaar

  • Reactie: Geen inhoud

  • Last updated on