Condividere un agente del workflow

Condividi gli agenti del workflow che hai creato e lanciato utilizzando Workflow Builder con altri utenti della tua organizzazione.

Con la condivisione degli agenti puoi:

  • Condividere gli agenti live con utenti e gruppi della tua organizzazione.
  • Configurare pianificazioni di esecuzione personalizzate o trigger basati su eventi.
  • Monitorare le esecuzioni in anteprima e le esecuzioni automatiche.
  • Duplicare gli agenti del workflow condivisi per personalizzarne i passaggi.

A seconda delle configurazioni di controllo delle funzionalità dell'app , potrebbe essere necessario che un amministratore esamini e approvi la tua richiesta prima di poter condividere un agente.

Condividere un agente del workflow

Per condividere un agente del workflow:

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 che vuoi condividere.

  3. Nell'intestazione in alto a destra del canvas di Workflow Builder, fai clic su Icona di condivisione Condividi.

  4. Inserisci gli indirizzi email degli utenti o dei gruppi Google con cui vuoi condividere l'agente.

  5. Fai clic su Fine.

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 di controllo delle funzionalità dell'app per richiedere la revisione e l'approvazione dell'amministratore per la condivisione degli agenti nell'app.

Per impostazione predefinita, i proprietari degli agenti non possono condividere i propri agenti con i gruppi. Tuttavia, l'amministratore dell'app Gemini Enterprise può scegliere di rendere gli agenti condivisibili con i gruppi Google, con o senza l'approvazione dell'amministratore.

La procedura di condivisione

Solo la condivisione iniziale di un agente richiede la revisione e l'approvazione dell'amministratore. Le revisioni successive dell'agente non richiedono una nuova approvazione.

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

  1. Il proprietario dell'agente condivide l'agente con uno o più utenti o gruppi Google.

  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.

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.

    Condividi richiesta di revisione dell'agente

  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à 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.

Utilizzare un agente condiviso

Quando il proprietario di un agente condivide un agente del workflow con te, puoi accedere e visualizzare l'anteprima della sua configurazione del grafico. Sebbene il grafico del workflow sia di sola lettura per gli utenti condivisi, puoi eseguire manualmente un'anteprima, configurare le tue impostazioni dei trigger, visualizzare la tua cronologia delle esecuzioni, o creare una copia dell'agente.

App

  1. Apri l'app web Gemini Enterprise in un browser.
  2. Nel menu di navigazione dell'app web, fai clic su Icona Agenti Agenti.
  3. Vai alla sezione Condivisi con me > Dalla tua organizzazione.

  4. Fai clic sull'agente del workflow condiviso che vuoi visualizzare. L'agente viene avviato in un layout di progettazione di sola lettura, che mostra il grafico dei nodi live. Nota: se l'agente condiviso è sospeso o disattivato, il canvas di Workflow Builder non viene visualizzato, ma puoi comunque visualizzare le sue esecuzioni.

  5. (Facoltativo) Per eseguire un'esecuzione di test manuale del workflow dell'agente:

    • Fai clic su Anteprima nell'intestazione in alto a destra del canvas di Workflow Builder.
    • Esegui l'anteprima. Se l'esecuzione dell'anteprima non riesce perché un connettore utilizzato dal workflow non è autorizzato, fai clic su Attiva connettori sotto il messaggio di errore per completare il flusso OAuth.

Configurare i propri trigger

I trigger di un agente condiviso sono specifici per l'utente. Puoi configurare una pianificazione di esecuzione personalizzata o filtri di eventi per eseguire automaticamente un agente condiviso.

Per configurare i tuoi trigger:

App

  1. Apri l'app web Gemini Enterprise in un browser.
  2. Nel menu di navigazione dell'app web, fai clic su Icona Agenti Agenti > Galleria.
  3. Vai alla sezione Condivisi con me > Dalla tua organizzazione e fai clic sull'agente del workflow condiviso per cui vuoi configurare un trigger.

  4. Accedi alla configurazione del trigger:

    • Seleziona il menu Azioni > Configura trigger.
    • In alternativa, apri l'agente del workflow nel canvas dell'editor di Workflow Builder, fai clic sul titolo dell'agente e seleziona Configura trigger.

  5. Puoi configurare un trigger utilizzando una delle seguenti modalità:

    • Pianificazione: seleziona Esegui in base a una pianificazione e configura quando l'agente deve essere eseguito (ad esempio la frequenza e il fuso orario).
    • Evento: seleziona Esegui in base agli eventi dell'app e configura i filtri degli eventi per specificare quando l'agente deve essere eseguito. Ad esempio, per un trigger di eventi di Google Drive, puoi filtrare in base a campi come Proprietari (ad esempio un ID Google come janedoe), Nome, Tipo MIME, Ora di modifica o Cartella principale. Seleziona un operatore (ad esempio contiene o uguale a), inserisci un valore e combina più regole utilizzando le condizioni AND o OR.

  6. Se il workflow utilizza connettori che richiedono l'autenticazione (ad esempio, connettori utilizzati in un passaggio dell'agente anziché nel trigger stesso), abilita e autorizza i connettori nell'editor del canvas di Workflow Builder quando richiesto.

  7. Fai clic su Salva. Il trigger viene salvato e l'agente viene eseguito automaticamente. Puoi attivare manualmente l'agente per visualizzare l'anteprima di cosa accadrà quando il trigger di pianificazione o di eventi lo eseguirà. Se vuoi che l'agente smetta di essere eseguito, seleziona Non eseguire in base agli eventi dell'app o Non eseguire in base a una pianificazione nella finestra Configura trigger.

Visualizzare le esecuzioni

Per visualizzare le esecuzioni:

App

  1. Nel menu di navigazione dell'app web, fai clic su Icona Agenti Agenti.
  2. Vai alla sezione Condivisi con me > Dalla tua organizzazione e fai clic sull'agente del workflow condiviso.
  3. Nel canvas di Workflow Builder, fai clic sulla scheda Esecuzioni.
  4. Fai clic su un'esecuzione specifica per visualizzare i log di esecuzione e la traccia passo passo.

Per saperne di più, consulta Esecuzioni dell'agente del workflow.

Creare una copia di un agente del workflow condiviso

Gli agenti condivisi sono di sola lettura per gli utenti condivisi, ad eccezione delle configurazioni dei trigger. Se vuoi modificare e personalizzare i passaggi del workflow di un agente condiviso, puoi crearne una copia nella tua area di lavoro.

Per creare un duplicato modificabile dell'agente condiviso:

App

  1. Apri l'app web Gemini Enterprise in un browser.
  2. Nel menu di navigazione dell'app web, fai clic su Icona Agenti Agenti > Galleria.
  3. Vai alla sezione Condivisi con me > Dalla tua organizzazione e fai clic sull'agente del workflow condiviso che vuoi copiare.
  4. Nel canvas dell'editor di Workflow Builder, fai clic sul titolo dell'agente e seleziona Crea una copia. La copia viene aggiunta all'elenco I tuoi agenti.

Dipendenze degli agenti condivisi

Se l'agente importa e fa riferimento ad altri agenti (sub-agenti) nei passaggi del workflow, tieni presente quanto segue:

  • Requisiti di accesso: quando condividi un agente parent o quando importi un agente nel tuo agente, assicurati che tutti gli utenti nell'elenco per gli accessi abbiano accesso anche a tutti i sub-agenti importati.
  • Errori di esecuzione: se un utente esegue un agente senza accesso a un sub-agente importato, l'esecuzione non riesce e viene visualizzato un messaggio che chiede all'utente di richiedere l'accesso al proprietario.

Considerazioni

  • Se il proprietario dell'agente attiva una nuova versione o aggiorna la versione live dell'agente del workflow, tutti gli utenti condivisi eseguono automaticamente la nuova versione live nelle esecuzioni successive.

  • Se un agente è disattivato o sospeso, il canvas di Workflow Builder non viene visualizzato e gli utenti condivisi non possono eseguire l'agente, ma possono comunque visualizzare le cronologie delle esecuzioni passate e i log delle sessioni nella galleria Esecuzioni. Se l'agente non è condiviso, è disattivato o eliminato, gli utenti condivisi perdono tutto l'accesso, incluse le cronologie delle esecuzioni passate e i log delle sessioni.

  • Le azioni che modificano i dati esterni richiedono l'approvazione di un operatore umano (HITL), ad eccezione delle email o degli eventi di calendario che invii a te stesso.

Passaggi successivi