Eigendom van verweesde agents opnieuw toewijzen met de Power Platform-API

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

Het opnieuw toewijzen van eigendom van verweesde agents maakt deel uit van het bredere framework voor beveiliging van Copilot Studio en is een onlosmakelijk onderdeel van uw algehele beveiligingsbenadering in Copilot Studio.

Er kunnen bijvoorbeeld verweesde agents ontstaan die niet goed beheerd worden als de oorspronkelijke eigenaar van een agent de organisatie verlaat of van rol verandert. Deze situatie kan bedrijfsprocessen verstoren en beveiligingsrisico’s veroorzaken, aangezien er mogelijk geen verantwoordelijke is om de agentinstellingen en compliancevereisten te beheren. Beheerders kunnen de API Opnieuw toewijzen gebruiken om het eigenaarschap van deze verweesde agents opnieuw toe te wijzen, zodat ze goed beheerd en compliant blijven.

Agentgebruikers en -makers in Copilot Studio kunnen agents zien die opnieuw zijn toegewezen. De nieuwe eigenaar krijgt de machtigingen van de omgevingsmaker voor de agentomgeving. De oude eigenaar verliest de toegang tot de agent nadat het eigenaarschap opnieuw is toegewezen. Als de nieuwe eigenaar na de overdracht van het eigendom van een agent de bevoegdheid Transcriptie lezen heeft, kan hij toegang krijgen tot alle bestaande transcripties van de agent.

Belangrijk

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

Vereisten

  • U hebt de bot- en omgevings-id voor de doelagent.
  • U moet een gebruikerstoegangstoken verkrijgen die is uitgegeven door Microsoft Entra ID OAuth2. Om een token te verkrijgen, zie Verificatie.
    • Om de eigenaar van een in Copilot Studio gemaakte agent te wijzigen, moet de gebruiker die aan het token is gekoppeld een van de volgende beheerdersrollen hebben:
      • Algemene tenantbeheerder
      • AI-beheerder
      • Power Platform-beheerder
      • Omgevingsbeheerder
    • Om de eigenaar van een in de agentopbouwfunctie gemaakte agent te wijzigen, moet de gebruiker die aan het token is gekoppeld een van de volgende beheerdersrollen hebben:
      • Algemene tenantbeheerder
      • AI-beheerder
      • Power Platform-beheerder
    • U moet het toegangstoken verkrijgen met behulp van de client-ID van een app-registratie waaraan de CopilotStudio.AdminActions.Invoke-scope is toegekend onder de Power Platform API.
  • U hebt de Entra-gebruikers-id van de nieuwe eigenaar aan wie het eigenaarschap van de agent moet worden toegewezen.
  • De nieuwe eigenaar moet behoren tot de tenant.

API-bewerkingen voor het opnieuw toewijzen van het eigendom van een agent

Copilot Studio ondersteunt de REST API-bewerking reassign voor het opnieuw toewijzen van agenten aan nieuwe eigenaren als onderdeel van de Power Platform-API.

Notitie

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

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

Het eigendom van een agent toewijzen 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 door de Entra-gebruikers-id van de nieuwe eigenaar.

  • Doel: het eigenaarschap van de agent wijzigen

  • Respons: geen inhoud

  • Last updated on