Condividere un agente di chat

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

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 dei file caricati nella sezione Conoscenza dell'agente, anche se non dispone di accesso diretto o autorizzazioni per i file di origine. Ad esempio, se carichi un file riservato nella sezione Knowledge, 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 utente. 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 di 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, che mostra tutti gli agenti predefiniti e personalizzati.

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

   Nota :non puoi condividere un agente di chat che si trova nello stato draft.

3. Fai clic sul 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 il tuo agente di chat con indirizzi email di singoli utenti. La condivisione con Google Gruppi non è supportata.
   • Se la tua app web è connessa a un datastore People Search con il completamento automatico configurato per i dati utente, la finestra di dialogo di condivisione fornisce suggerimenti di compilazione automatica man mano che inserisci gli indirizzi email degli utenti.

5. Fai clic su Fine.

   L'agente di 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, una richiesta di condivisione viene inviata all'amministratore dell'app per la revisione e l'approvazione. Dopo che l'amministratore dell'app approva la richiesta, l'agente di 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 annullarla.

Controllo della revisione dell'amministratore

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

La condivisione degli agenti segue un processo in due fasi quando è attivata la revisione dell'amministratore:

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 delle 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 delle app con il ruolo IAM Amministratore Gemini Enterprise possono esaminare e approvare le richieste di condivisione.

Console

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

1. Nella console Google Cloud , 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 l'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 nella sezione 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 account individuali:Gemini Enterprise gestisce l'accesso degli agenti utilizzando i criteri di autorizzazione IAM Google Cloud sottostanti, che impongono un limite massimo di 1500 membri per criterio. La condivisione di un agente con più di 1500 account utente individuali causa il mancato completamento 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 di chat, gli utenti possono eseguire query sui contenuti dei file caricati nella sezione Knowledge indipendentemente dall'accesso diretto ai file, mentre i dati a cui si accede tramite i connettori continuano a rispettare le autorizzazioni dei singoli utenti e gli elenchi di controllo degli accessi (ACL).
• Gli amministratori delle app possono aggiungere e rimuovere utenti dall'elenco per gli accessi in qualsiasi momento.
• Solo gli amministratori delle app possono condividere l'agente con i gruppi Google e i pool di identità della federazione delle identità per la forza lavoro (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).
• Gli amministratori delle app possono trasferire la proprietà di un agente di chat condiviso a un altro utente o a se stessi nella console Google Cloud . Per ulteriori informazioni, vedi Trasferire la proprietà dell'agente.
• Puoi anche condividere un agente di chat dal canvas del builder di agenti di chat.

Passaggi successivi

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