Estendere Google Workspace Studio

Queste guide spiegano come estendere la funzionalità di Google Workspace Studio creando passaggi personalizzati che i flussi possono eseguire.

Per iniziare, segui la guida rapida Crea un passaggio di calcolo con Apps Script.

Prova la guida rapida

Flows consente agli utenti di Google Workspace di automatizzare le attività nei servizi combinando una serie di passaggi senza scrivere codice. Estendendo i flussi, consenti agli utenti di aggiungere le funzioni della tua app come passaggi.

Ad esempio, gli utenti possono eseguire il triage e assegnare le domande dei clienti in arrivo con un flusso che esegue le seguenti operazioni:

  1. Riceve un'email da un cliente.
  2. Chiede a Gemini di eseguire il triage dell'email.
  3. Crea un'attività per il follow-up con il team di vendita o di assistenza.
Interfaccia di Flussi che mostra i passaggi per ricevere le email dei clienti, richiedere a Gemini e creare attività di follow-up.
Figura 1: un utente configura un flusso che smista le domande dei clienti con Gemini.

Concetti di Workspace Studio

I seguenti termini e concetti definiscono i componenti chiave di Workspace Studio:

Flussi

Utenti della build

flussi in Workspace Studio per automatizzare le attività in Google Workspace e non solo. I flussi hanno un'integrazione profonda nel sistema, sono sensibili al contesto e possono utilizzare l'AI in modo facoltativo.

Step

Un singolo passaggio nel processo automatizzato di un flusso. In sostanza, si tratta di una singola attività in una sequenza di attività che seguono un evento iniziale. Ogni passaggio viene eseguito in modo sincrono, il che significa che completa l'operazione prima dell'inizio del passaggio successivo nella sequenza. Gli utenti impostano l'ordine dei passaggi, consentendo loro di personalizzare il flusso logico delle attività. I passaggi possono avere input e output, ma non sono obbligatori. I passaggi di esempio includono "invia un'email", "pubblica in uno spazio di Chat" e "chiedi a Gemini". I passaggi possono includere attività esterne a Google Workspace, ad esempio la creazione di un lead CRM.

Starter
Il punto di ingresso del processo automatizzato di un flusso. Nell'interfaccia utente, viene presentato agli utenti come Starter, mentre nello schema del manifest e nell'API Google Workspace Studio, è definito come workflowTrigger. Mentre un passaggio esegue un'azione sincrona al centro di una sequenza, un comando iniziale si trova all'inizio del flusso e ascolta un evento (da app Google Workspace o webhook di terze parti). Una volta attivato, acquisisce i dettagli dell'evento, restituisce le variabili di dati iniziali e avvia l'esecuzione del flusso.
Variabile di input
Le variabili di input
vengono ricevute dai passaggi. Le variabili di input vengono impostate dall'utente nella scheda di configurazione di un passaggio durante la configurazione del passaggio. Ad esempio, raccogli un indirizzo email, una data e un'ora o un prompt di Gemini.
Variabile di output
Le variabili di output
vengono restituite dai passaggi e possono essere inviate a un altro passaggio. Ad esempio, utilizzi una variabile di output per passare un indirizzo email a un altro passaggio che lo utilizza per specificare il destinatario di un'email.
Variabile dinamica
Una variabile i cui dati possono essere determinati solo quando l'utente configura il flusso. Ad esempio, i Moduli Google hanno domande e risposte diverse. Il numero di domande e risposte (e il loro contenuto) non può essere determinato finché un modulo specifico non avvia un flusso. Le variabili dinamiche tengono conto di questo caso.
Risorsa personalizzata
Una struttura di dati personalizzata che puoi definire per raggruppare più variabili. Ad esempio, per creare un lead CRM, trasmetti una risorsa personalizzata contenente un indirizzo email, un indirizzo e un nome.
Scheda

Componente di base per le interfacce utente nei componenti aggiuntivi. Le schede supportano un layout definito, elementi UI interattivi come pulsanti e rich media come immagini. Le schede hanno funzionalità speciali per la creazione di flussi:

  • IncludeVariables: una proprietà che consente l'inclusione di variabili dinamiche.
  • Type: definisce il tipo di dati previsto dalle variabili di input.
Log delle attività
Descrive cosa succede quando viene eseguito un flusso. Per impostazione predefinita, i log delle attività includono il nome del comando iniziale o del passaggio definito staticamente nel manifest. Puoi anche fornire log attività personalizzati.

Scopri cosa puoi creare

I flussi sono basati sulla piattaforma di componenti aggiuntivi in Google Workspace. Se hai già un componente aggiuntivo esistente, puoi estenderne la funzionalità per includere i flussi aggiornando il relativo file manifest in modo che contenga una sezione specifica per i flussi.

Se parti da zero, segui la guida rapida Crea un passaggio di calcolo con Apps Script.

Prova una guida rapida

Poi leggi queste guide per continuare a personalizzare il passaggio del flusso: