Estendere Google Workspace Studio

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

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

Prova la guida rapida

Gli agenti consentono agli utenti di Google Workspace di automatizzare le attività nei vari servizi combinando una serie di passaggi senza scrivere codice. Estendendo gli agenti, consenti agli utenti di aggiungere le funzioni della tua app come passaggi.

Ad esempio, gli utenti possono mettere in evidenza i nuovi messaggi di vendita con un agente che esegue le seguenti operazioni:

  1. Inizia quando ricevi un'email.
  2. Chiede a Gemini di riassumere l'email.
  3. Pubblica un messaggio sull'email in uno spazio di Chat.

Configurazione di un agente

Figura 1: un utente configura un agente che mette in evidenza i nuovi messaggi di vendita.

Concetti di Workspace Studio

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

Agenti
Gli utenti creano agenti in Workspace Studio per automatizzare le attività in Google Workspace e non solo. Gli agenti hanno un'integrazione profonda del sistema, consapevolezza contestuale e possono utilizzare l'AI in modo facoltativo.
Step
Un singolo passaggio nella procedura automatica di un agente. 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. Alcuni esempi di passaggi includono "invia un'email", "pubblica in uno spazio di chat" e "chiedi a Gemini". I passaggi possono includere attività esterne a Google Workspace, come la creazione di un lead CRM.
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 l'agente. 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 agente. 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, passa una risorsa personalizzata contenente un indirizzo email, un indirizzo civico e un nome.
Carta

Elemento di base per le interfacce utente nei componenti aggiuntivi. Le schede supportano un layout definito, elementi UI interattivi come pulsanti e contenuti multimediali avanzati come immagini. Le schede hanno funzionalità speciali per la creazione di agenti:

  • 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 agente. Per impostazione predefinita, i log delle attività includono il nome dell'intent o del passaggio definito staticamente nel manifest. Puoi anche fornire log attività personalizzati.

Scopri cosa puoi creare

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

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

Prova una guida rapida

Poi leggi queste guide per continuare a personalizzare il passaggio dell'agente: