Omtilldela äganderätt för överblivna agenter med Power Platform API:t

Copilot Studio ger administratörer robusta verktyg för att hantera agentsäkerhet och -efterlevnad, inklusive möjligheten att omtilldela ägarskapet till överblivna agenter via Power Platform-API:et.

Att omtilldela ägarskap över överblivna agenter är en del av det bredare säkerhetsramverket i Copilot Studio och fungerar tillsammans med din övergripande säkerhetsstrategi i Copilot Studio.

Till exempel: När den ursprungliga ägaren av en agent lämnar organisationen eller byter roll kan det leda till överblivna agenter som saknar korrekt hantering. Denna situation kan störa affärsprocesser och skapa säkerhetsrisker eftersom det kanske inte finns någon ansvarig part för att hantera agentens inställningar och efterlevnadskrav. Administratörer kan använda Reassign-API:et för att omtilldela äganderätten till dessa överblivna agenter och säkerställa att de förblir korrekt hanterade och uppfyller krav på efterlevnad.

Agentanvändare och skapare i Copilot Studio kan se agenter som har fått ny ägare. Den nya ägaren får miljöskaparbehörigheter för agentens miljö. Den tidigare ägaren förlorar åtkomsten till agenten efter det att ägarskapet har överförts. Efter att ägarskapet till en agent har överförts: Om den nya ägaren har behörigheten Läs transkription kan denna komma åt alla befintliga transkriptioner för agenten.

Viktigt

Namnrymden powervirtualgents är föråldrad. Använd copilotstudio namnrymden i dina API-anrop.

Krav

  • Du har robot-ID och miljö-ID för målagenten.
  • Du måste erhålla en användaråtkomsttoken som utfärdats av Microsoft Entra ID OAuth2. För att erhålla en token, se Autentisering.
    • För att överföra ägarskapet för en agent som skapats i Copilot Studio måste användaren som är kopplad till en token ha en av följande administratörsroller:
      • Global klientorganisationsadministratör
      • AI-administratör
      • Power Platform-administratör
      • Miljöadministratör
    • För att tilldela en ny ägare för en agent som skapats i Agent Builder måste användaren som är associerad med tillhörande token ha en av följande administratörsroller:
      • Global klientorganisationsadministratör
      • AI-administratör
      • Power Platform-administratör
    • Du måste skaffa åtkomsttoken med klient-ID för en appregistrering som har omfånget CopilotStudio.AdminActions.Invoke beviljat under Power Platform-API:et.
  • Du har användar-ID till Entra på den nya ägaren som ska ta över ägarskapet för agenten.
  • Den nya ägaren måste tillhöra klientorganisationen.

API-operationer för att omtilldela agentägarskap

Copilot Studio stöder REST API-åtgärden reassign för att tilldela om överblivna agenter åt nya ägare som en del av Power Platform-API:et.

Kommentar

Omtilldela-API:t har inte stöd för klassiska chattrobotar. API:t returnerar 405 Method Not Allowed när du försöker ändra ägarskapet för en klassisk chattrobot.

Mer information om hur och när du ska använda Power Platform-API:et finns i:

Tilldela en agent till en ny ägare

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

  • Brödtext: {"NewOwnerAadUserId": "EntraUserId"}

    Ersätt EntraUserId med Entra User-ID för den nya ägaren.

  • Syfte: Ändra ägare för agenten

  • Svar: Tomt svar

  • Last updated on