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

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

La riassegnazione della proprietà degli agenti orfani è parte del framework di sicurezza più ampio di Copilot Studio e funziona in collaborazione con l'approccio di sicurezza generale in Copilot Studio.

Ad esempio, quando il proprietario originale di un agente lascia l'organizzazione o cambia ruolo, si possono creare agenti orfani privi di una gestione adeguata. Questa situazione può interrompere i processi aziendali e creare rischi per la sicurezza, poiché potrebbe non esserci un soggetto responsabile preposto a gestire le impostazioni e i requisiti di conformità dell'agente. Gli amministratori possono usare l'API di riassegnazione per riassegnare la proprietà di questi agenti orfani e garantire che continuino a essere conformi e gestiti correttamente.

Gli utenti e i creatori di agenti in Copilot Studio possono vedere gli agenti riassegnati. Il nuovo proprietario riceve i permessi di autore dell'ambiente per l'ambiente dell'agente. Il precedente proprietario perde l'accesso all'agente dopo la riassegnazione. Dopo la riassegnazione della proprietà di un agente, se il nuovo proprietario possiede il privilegio di Lettura della trascrizione, può accedere a tutte le trascrizioni esistenti dell'agente.

Importante

Lo spazio dei nomi powervirtualgents è deprecato. Usa lo spazio dei nomi copilotstudio nelle chiamate API.

Prerequisiti

  • Hai 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, vedi Autenticazione.
    • Per riassegnare il proprietario di un agente creato in Copilot Studio, l'utente associato al token deve possedere uno dei seguenti ruoli di amministratore:
      • Amministratore tenant globale
      • Amministratore IA
      • Amministratore di Power Platform
      • Amministratore dell'ambiente
    • Per riassegnare il proprietario di un agente creato nel generatore di agenti, l'utente associato al token deve possedere uno dei seguenti ruoli di amministratore:
      • Amministratore tenant globale
      • Amministratore IA
      • Amministratore di Power Platform
    • Devi acquisire il token di accesso usando l'ID client di una registrazione app che abbia l'ambito CopilotStudio.AdminActions.Invoke concesso nell'API Power Platform.
  • Hai l'ID utente di Entra del nuovo proprietario a cui si deve riassegnare la proprietà dell'agente.
  • Il nuovo proprietario deve appartenere al tenant.

Operazioni API per la riassegnazione della proprietà degli agenti

Copilot Studio supporta l'operazione reassign dell'API REST per la riassegnazione degli agenti orfani a nuovi proprietari, come parte dell'API di Power Platform.

Nota

L'API di riassegnazione non supporta i chatbot classici. L'API restituisce 405 Method Not Allowed quando provi a riassegnare la proprietà di un chatbot classico.

Per ulteriori informazioni su come e quando utilizzare l'API Power Platform, vedi:

Riassegnare 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 di Entra del nuovo proprietario.

  • Scopo: cambiare il proprietario dell'agente

  • Risposta: nessun contenuto

  • Last updated on