Riassegna la proprietà degli agenti orfani con l'API Power Platform

Copilot Studio offre agli amministratori strumenti robusti per gestire la sicurezza e la conformità dei bot, inclusa la possibilità di riassegnare la proprietà degli agenti orfani tramite l'API Power Platform.

La riassegnazione della proprietà degli agenti orfani fa parte del più ampio quadro di sicurezza di Copilot Studio e funziona in sinergia con il vostro approccio complessivo alla sicurezza in Copilot Studio.

Ad esempio, quando il proprietario originale di un agente lascia l'organizzazione o cambia ruolo, gli agenti possono rimanere senza una gestione adeguata. Questa situazione può interrompere i processi aziendali e creare rischi per la sicurezza, poiché potrebbe non esserci una parte responsabile per gestire le impostazioni e i requisiti di conformità dell'agente. Gli amministratori possono utilizzare l'API Reassign per riassegnare la proprietà di questi agenti orfani, assicurandosi che rimangano gestiti correttamente e conformi.

Gli utenti e i creatori di agenti in Copilot Studio possono visualizzare gli agenti riassegnati. Il nuovo proprietario riceve i permessi di gestione per l'ambiente del bot. Il vecchio proprietario perde l'accesso all'agente dopo la riassegnazione.

Important

Il powervirtualgents namespace è obsoleto. Usa il copilotstudio namespace nelle chiamate API.

Prerequisiti

  • Avete l'ID bot e l'ID ambiente per l'agente di destinazione.
  • È necessario ottenere un token di accesso utente rilasciato da Microsoft Entra ID OAuth2. Per ottenere un token, vedere Autenticazione.
    • Per riassegnare il proprietario di un agente creato in Copilot Studio, l'utente associato al token deve avere uno dei ruoli di amministratore seguenti:
      • Amministratore del tenant globale
      • Amministratore di intelligenza artificiale
      • Amministratore di Power Platform
      • Amministratore dell'ambiente
    • Per riassegnare il proprietario di un agente creato in Agent Builder, l'utente associato al token deve avere uno dei seguenti ruoli amministrativi:
      • Amministratore del tenant globale
      • Amministratore di intelligenza artificiale
      • Amministratore di Power Platform
    • Devi acquisire il token di accesso utilizzando l'ID client di una registrazione di un'app che ha l'ambito CopilotStudio.AdminActions.Invoke concesso dall'API Power Platform.
  • Hai l'ID utente Entra del nuovo proprietario a cui la proprietà dell'agente deve essere riassegnata.
  • Il nuovo proprietario deve appartenere all'inquilino.

Operazioni API per la riassegnazione della proprietà degli agenti

Copilot Studio supporta l'operazione REST API reassign per riassegnare agenti orfani ai nuovi proprietari, come parte dell'API Power Platform.

Note

L'API Riassegna non supporta chatbot classici. L'API restituisce 405 Method Not Allowed quando si tenta di riassegnare la proprietà di un chatbot classico.

Per altre informazioni su come e quando usare l'API Power Platform, vedere:

Riassegna la proprietà di un agente a un nuovo proprietario

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

  • Corpo: {"NewOwnerAadUserId": "EntraUserId"}

    Sostituisci EntraUserId con l'ID utente Entra del nuovo proprietario.

  • Scopo: Cambiare proprietario dell'agente

  • Risposta: Nessun contenuto

  • Last updated on