Condividere un agente di chat

Condividi gli agenti chat che hai creato e avviato utilizzando Workflow Builder con altri utenti della tua organizzazione. A seconda delle configurazioni dei controlli delle funzionalità della tua app web, potrebbe essere necessario che un amministratore dell'app Gemini Enterprise esamini e approvi la condivisione di un agente chat.

Attenzione: quando condividi un agente, tieni presente i seguenti comportamenti di accesso ai dati:

• File di conoscenza: qualsiasi utente con accesso all'agente condiviso può eseguire query e visualizzare le informazioni dai file caricati nella sezione Conoscenza dell'agente, anche se non ha accesso diretto o autorizzazioni per i file di origine. Ad esempio, se carichi un file riservato nella sezione Conoscenza, tutti gli utenti con accesso all'agente condiviso possono porre domande sui contenuti del file.
• Connettori e datastore: quando un agente accede ai dati tramite i connettori, vengono mantenuti gli elenchi di controllo dell'accesso (ACL) e le autorizzazioni degli utenti. Gli utenti possono eseguire query e recuperare dati solo da datastore e connettori a cui i loro singoli account utente sono autorizzati ad accedere.

Condividere un agente chat

Per condividere un agente chat:

App

1. Apri l'app Gemini Enterprise e vai alla pagina Galleria di agenti.

   Viene visualizzata la pagina Galleria di agenti con tutti gli agenti predefiniti e personalizzati.

2. Nella sezione I tuoi agenti, individua l'agente chat che vuoi condividere.

   Nota: non puoi condividere un agente chat in stato di draft stato.

3. Fai clic su menu Azioni e seleziona Condividi.

4. Nella finestra di dialogo di condivisione, inserisci gli indirizzi email degli utenti con cui vuoi condividere l'agente. Puoi anche fare clic su Copia link per generare un link condivisibile.

   Note:

   • Puoi condividere l'agente chat con i singoli indirizzi email degli utenti. La condivisione con i Gruppi Google non è supportata.
   • Se la tua app web è connessa a un datastore di People Search con completamento automatico configurato per i dati utente, la finestra di dialogo di condivisione fornisce suggerimenti di compilazione automatica quando inserisci gli indirizzi email degli utenti.

5. Fai clic su Fine.

   L'agente chat viene condiviso con gli utenti nell'elenco per gli accessi.

   Nota: se l'amministratore dell'app web ha attivato la revisione dell'amministratore per la condivisione degli agenti, viene inviata una richiesta di condivisione all'amministratore dell'app per la revisione e l'approvazione. Dopo che l'amministratore dell'app ha approvato la richiesta, l'agente chat viene condiviso con gli utenti nell'elenco per gli accessi. Puoi modificare la richiesta di condivisione in qualsiasi momento per aggiungere o rimuovere utenti oppure annullare la richiesta.

Controllo della revisione dell'amministratore

Per impostazione predefinita, i proprietari degli agenti possono condividere i propri agenti con qualsiasi utente della propria organizzazione senza l'approvazione di un amministratore dell'app. Tuttavia, gli amministratori dell'app possono modificare le configurazioni dei controlli delle funzionalità dell'app per richiedere la revisione e l'approvazione dell'amministratore per la condivisione degli agenti nell'app.

Quando la revisione dell'amministratore è attivata, la condivisione degli agenti segue una procedura in due passaggi:

1. Il proprietario dell'agente condivide l'agente con uno o più utenti.
2. L'amministratore dell'app esamina la richiesta di condivisione e la approva o la rifiuta.

Esaminare una richiesta di condivisione

Gli amministratori dell'app sono responsabili della revisione e della gestione delle richieste di condivisione degli agenti.

Note:

• Questa sezione si applica solo se la funzionalità Abilita la condivisione degli agenti senza l'approvazione dell'amministratore è disattivata nei controlli delle funzionalità dell'app.
• Solo gli amministratori dell'app con il ruolo IAM Amministratore di Gemini Enterprise possono esaminare e approvare le richieste di condivisione.

Console

Per esaminare una richiesta di condivisione come amministratore dell'app:

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

   Gemini Enterprise

2. Fai clic sul nome dell'app contenente l'agente.

3. Nel menu di navigazione dell'app, fai clic su Agenti.

4. Individua l'agente con un'azione Esamina richiesta di condivisione nella colonna Autorizzazioni utente.

   

5. Fai clic su Esamina richiesta di condivisione.

6. Nel riquadro Richiesta di condivisione:

   • Esamina l'elenco per gli accessi in Richiesta di condivisione con i seguenti utenti.
   • (Facoltativo) Modifica l'elenco per gli accessi per aggiungere o rimuovere account utente, Google Gruppi o pool di identità di Workforce Identity Federation (WIF).

7. Per approvare la richiesta e concedere l'accesso, fai clic su Approva e attiva.

8. Per rifiutare la richiesta, fai clic su Nega.

Limiti di condivisione

Quando condividi un agente chat, si applicano i seguenti limiti:

• Massimo 1500 singoli account: Gemini Enterprise gestisce l'accesso degli agenti utilizzando i criteri di autorizzazione Google Cloud IAM sottostanti, che impongono un limite massimo di 1500 membri per criterio. La condivisione di un agente con più di 1500 singoli account utente comporta l'esito negativo dell'operazione con il seguente errore:

  The number of members in the policy (1,501) is larger than the maximum allowed size 1,500.
  

Per un elenco completo dei vincoli di sistema, consulta Quote e limiti di Workflow Builder.

Considerazioni

• Quando condividi un agente chat, gli utenti possono eseguire query sui contenuti dei file caricati nella sezione Conoscenza indipendentemente dall'accesso diretto ai file, mentre i dati a cui si accede tramite i connettori continuano a rispettare le singole autorizzazioni utente e gli elenchi di controllo dell'accesso (ACL).
• Gli amministratori dell'app possono aggiungere e rimuovere utenti dall'elenco per gli accessi in qualsiasi momento.
• Solo gli amministratori dell'app possono condividere l'agente con i Gruppi Google e i pool di identità di Workforce Identity Federation (WIF) nella tua organizzazione.
• I proprietari degli agenti possono rimuovere qualsiasi utente dall'elenco per gli accessi in qualsiasi momento (inclusi quelli aggiunti dall'amministratore dell'app).
• Puoi anche condividere un agente chat dalla tela del builder di agenti chat.

Passaggi successivi

• Scopri come utilizzare un agente chat.
• Scopri come pianificare le esecuzioni degli agenti chat.
• Scopri come modificare un agente chat.
• Scopri come eliminare un agente chat.
• Visualizza le quote e i limiti di Workflow Builder.