Condividere gli agenti dalla console Google Cloud

Questa pagina spiega come condividere gli agenti con gli utenti della tua organizzazione. 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. Per saperne di più sui diversi tipi di agenti disponibili in Gemini Enterprise, consulta Panoramica degli agenti.

Nota :per condividere gli agenti creati dai dipendenti, devi aver creato uno o più agenti utilizzando Agent Designer nell'app web Gemini Enterprise. Per informazioni sulla creazione di agenti utilizzando Agent Designer, vedi Creare un agente utilizzando Agent Designer.

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
   • Registrare e gestire gli agenti ADK ospitati su Vertex AI Agent Engine
   • Aggiungere e gestire gli agenti A2A da Google Cloud Marketplace
   • Registrare e gestire gli agenti Dialogflow

Condividere un agente

Per condividere un agente:

Console

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

Vai a Gemini Enterprise

1. Seleziona il progetto.

2. Fai clic sulla tua app nella colonna Nome. Il menu di navigazione viene aggiornato.

3. Fai clic su Agenti nel menu di navigazione.

4. Fai clic sul Nome visualizzato dell'agente che vuoi condividere.

5. Fai clic sulla scheda Autorizzazioni utente. Viene visualizzata la pagina Utenti con autorizzazioni.

6. Fai clic su Aggiungi utente. Viene visualizzata la finestra di dialogo Aggiungi ruoli di autorizzazioni dell'utente all'agente.

7. Configura i dettagli dell'autorizzazione:

   1. Seleziona una delle seguenti opzioni nella sezione Tipo di membro:

      • Utente: un singolo utente finale. Affinché questo tipo di membro funzioni, devi includere il ruolo IAM corretto. Per saperne di più, consulta Ruoli e autorizzazioni IAM.

      • Gruppo: una raccolta di utenti finali. Affinché questo tipo di membro funzioni, devi includere il ruolo IAM corretto. Per saperne di più, consulta Ruoli e autorizzazioni IAM.

      • Entità: una singola identità in un gruppo di pool di identità della forza lavoro, che include gruppi esterni non gestiti da Google.

      • Pool di identità della forza lavoro: tutte le identità in un pool di identità della forza lavoro.

      • Tutti gli utenti: tutti gli utenti dell'organizzazione.

   2. Inserisci l'identificazione univoca del membro e seleziona un ruolo:

      Tipo di membro	Descrizione
      Utente	Inserisci gli indirizzi email nel campo Membro. Seleziona un ruolo nel campo Assegna ruolo.
      Gruppo	Inserisci gli indirizzi email nel campo Membro. Seleziona un ruolo nel campo Assegna ruolo.
      Principal	Una singola identità all'interno di un WIF.
      Pool di identità della forza lavoro	Inserisci Identificatore entità nel campo Membro. Seleziona un ruolo nel campo Assegna ruolo. Per esempi di set di entità, consulta Set di entità.
      Tutti gli utenti	Seleziona un ruolo nel campo Assegna ruolo.

8. Fai clic su Salva.

Set di entità

Di seguito sono riportati alcuni 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.
• 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.