Condividere gli agenti dalla console Google Cloud

Questa pagina spiega come condividere gli agenti con gli utenti della tua organizzazione e come gli amministratori possono trasferire la proprietà degli agenti condivisi. In qualità di amministratore, puoi condividere gli agenti disponibili (creati da Google, dai dipendenti e personalizzati) con singoli utenti, gruppi, gruppi di pool di identità della forza lavoro o tutti gli utenti della tua organizzazione e trasferire la proprietà degli agenti creati dai dipendenti condivisi a te o a un altro utente. Per saperne di più sui diversi tipi di agenti disponibili in Gemini Enterprise, consulta Panoramica degli agenti.

Prima di iniziare

Prima di poter condividere un agente, devi soddisfare i seguenti requisiti:

1. Devi disporre di un'app web Gemini Enterprise esistente. Per creare una nuova app, consulta Crea un'app.

2. Per condividere agenti personalizzati, devi averli registrati o aggiunti a Gemini Enterprise utilizzando una delle seguenti opzioni:

   • Registrare e gestire gli agenti A2A
   • Registra e gestisci gli agenti ADK ospitati su Agent Runtime su Gemini Enterprise Agent Platform
   • Aggiungere e gestire gli agenti A2A da Google Cloud Marketplace
   • Registrare e gestire gli agenti Dialogflow

Condividere un agente

Per condividere un agente:

Set di entità

Di seguito sono riportati esempi di set di entità che puoi specificare per il tipo di membro Pool di identità della forza lavoro:

Set principale	Descrizione
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID	Una singola identità in un WIF.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	Tutte le identità della forza lavoro in un gruppo.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	Tutte le identità della forza lavoro con un valore di attributo specifico.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	Tutte le identità in un pool di identità della forza lavoro.

Sostituisci i seguenti segnaposto con i valori nell'esempio di codice:

• PROJECT_NUMBER: il numero utilizzato nel percorso della risorsa per identificare un progetto Google Cloud specifico.
• GROUP_ID: un identificatore di gruppo specifico di un provider di identità (IdP) esterno, che consente di concedere l'accesso a tutti i membri di quel gruppo.
• POOL_ID: l'ID univoco del pool di identità della forza lavoro che crei in Google Cloud.
• SUBJECT_ID: l'identificatore soggetto univoco per una singola identità all'interno di un pool di identità della forza lavoro.
• ATTRIBUTE_NAME: un nome definito dall'utente di un attributo personalizzato che hai mappato da un provider di identità (IdP) esterno.
• ATTRIBUTE_VALUE: il valore specifico di ATTRIBUTE_NAME utilizzato per limitare l'accesso.

Trasferire la proprietà dell'agente

In qualità di amministratore, puoi trasferire la proprietà di un agente condiviso a un altro utente della tua organizzazione o a te stesso. Questa funzionalità è utile in scenari come:

• Dipendenti che lasciano l'organizzazione: trasferimento degli agenti creati dai dipendenti che lasciano l'organizzazione ai membri attivi del team per garantire una manutenzione ininterrotta.
• Trasferimenti di contrattisti:trasferimento degli agenti creati da lavoratori temporanei o a contratto al personale a tempo pieno.
• Ristrutturazione del team: riassegnazione delle responsabilità degli agenti man mano che i ruoli o i progetti si evolvono.

Considerazioni e limitazioni

Prima di trasferire la proprietà dell'agente, tieni presente le seguenti considerazioni e limitazioni:

• Autorizzazione amministratore:solo gli amministratori con il ruolo Amministratore Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) o Amministratore Discovery Engine (roles/discoveryengine.admin) possono trasferire la proprietà dell'agente. L'attuale proprietario dell'agente non può trasferire la proprietà a meno che non sia anche un amministratore.
• Solo agenti condivisi:puoi trasferire la proprietà solo degli agenti già condivisi. Nella pagina Agenti della console Google Cloud , la colonna Condivisione dell'agente deve mostrare Attivata. Gli agenti privati (non condivisi) non possono essere trasferiti.
• Unico proprietario: ogni agente ha un solo proprietario. Quando la proprietà viene trasferita, il destinatario selezionato diventa l'unico proprietario dell'agente.
• Accesso del proprietario precedente:quando la proprietà viene trasferita, il proprietario precedente viene declassato a utente dell'agente con il ruolo agentUser. Mantengono l'autorizzazione a eseguire query e l'agente, ma non possono più modificare la configurazione o le impostazioni dell'agente.
• Tipi di agenti supportati: il trasferimento della proprietà è supportato per gli agenti creati dai dipendenti (agenti low-code e del flusso di lavoro creati nell'app web).
• Agenti con pianificazioni o trigger:se l'agente trasferito ha un trigger di pianificazione o un trigger di evento, l'operazione di trasferimento li contrassegna come pianificazioni o eventi disattivati. Il nuovo proprietario deve attivare il trigger di pianificazione o evento prima di poter utilizzare l'agente.

Trasferire la proprietà di un agente

Per trasferire la proprietà di un agente: