Tilldela om ägarskap för ägarlösa agenter med Power Platform API

Copilot Studio ger administratörer robusta verktyg för att hantera botsäkerhet och efterlevnad, inklusive möjligheten att återtilldela ägarskap för övergivna agenter via API:et Power Platform.

Omtilldelning av ägarskapet för överblivna agenter är en del av Copilot Studios bredare säkerhetsramverk och fungerar i samklang 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 agenter utan tillsyn 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:t för att överlåta ägandeskapet av dessa ägarlösa agenter för att säkerställa att de förblir korrekt hanterade och uppfyller krav.

Agentanvändare och skapare i Copilot Studio kan se agenter som omplaceras. Den nya ägaren får miljöskaparbehörigheter i botens miljö. Den gamla ägaren förlorar access till agenten efter omtilldelningen.

Viktigt!

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

Förutsättningar

  • Du har robot-ID och miljö-ID för målagenten.
  • Du måste skaffa en användaråtkomsttoken utfärdad av Microsoft Entra ID OAuth2. Information om hur du hämtar en token finns i Autentisering.
    • Om du vill ändra ägaren för en agent skapad i Copilot Studio måste användaren kopplad till token ha någon av följande administratörsroller:
      • Global hyresgästadministratör
      • AI-administratör
      • Power Platform-administratör
      • Miljöadministratör
    • För att omfördela ägaren till en agent skapad i Agent Builder måste användaren som är kopplad till tokenen ha en av följande administratörsroller:
      • Global hyresgästadministratör
      • AI-administratör
      • Power Platform-administratör
    • Du måste skaffa en access-token genom att använda klient-ID:t för en appregistrering där CopilotStudio.AdminActions.Invoke-området har beviljats under Power Platform API.
  • Du har Entra-användar-ID:t för den nya ägaren till vilken agentägarskapet måste omallokeras.
  • Den nya ägaren måste tillhöra hyresgästen.

API-operationer för att omfördela agentägarskap

Copilot Studio stöder REST API-reassign åtgärd för omtilldelning av överblivna agenter till nya ägare som en del av Power Platform-API:et.

Anmärkning

Omtilldelnings-API:et stöder inte klassiska chattrobotar. API:et 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:

Omfördela ett mäklarägande 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"}

    Byt ut EntraUserId med den nya ägarens användar-ID i entra.

  • Syfte: Byt ägare till mäklaren

  • Svar: Inget innehåll

  • Last updated on