Creare azioni per l'Assistente Google utilizzando Actions Builder (livello 1)

1. Panoramica

Attenzione: le azioni di conversazione verranno ritirate il 13 giugno 2023. Per saperne di più, vedi Disattivazione delle azioni di conversazione.

La piattaforma per sviluppatori dell'Assistente Google ti consente di creare software per estendere le funzionalità dell'Assistente Google, un assistente personale virtuale, su più di un miliardo di dispositivi, tra cui smart speaker, telefoni, auto, TV, cuffie e altro ancora. Gli utenti interagiscono con l'assistente in una conversazione per svolgere diverse attività, ad esempio fare la spesa o prenotare una corsa. In qualità di sviluppatore, puoi utilizzare la piattaforma per sviluppatori dell'assistente per creare e gestire facilmente esperienze di conversazione piacevoli ed efficaci tra gli utenti e il tuo servizio di distribuzione di terze parti.

Questo codelab tratta concetti di base per lo sviluppo con l'Assistente Google; non è necessaria alcuna esperienza precedente con la piattaforma per completarlo. In questo codelab, crei una semplice Azione per l'Assistente Google che racconta la sua fortuna agli utenti, quando iniziano la loro avventura nella leggendaria terra di Gryffinberg. Nel codelab di Actions Builder di livello 2, puoi creare ulteriormente questa azione per personalizzare la fortuna dell'utente in base al suo input.

Cosa devi creare

In questo codelab, creerai un'azione semplice con le seguenti funzioni:

• Risponde agli utenti con un messaggio di saluto
• Pongono una domanda agli utenti. Quando rispondono, l'azione risponde in modo appropriato alla selezione dell'utente
• Fornisce chip di suggerimenti su cui gli utenti possono fare clic per fornire l'input
• Modifica il messaggio di saluto per l'utente in base al fatto che si tratti di un utente di ritorno

Al termine di questo codelab, l'azione completata avrà il seguente flusso conversazionale:

Obiettivi didattici

• Come creare un progetto nella Console Actions
• Come inviare un messaggio all'utente dopo che ha richiamato la tua azione
• Come elaborare l'input di un utente e restituire una risposta
• Come testare l'Azione nel simulatore di Actions
• Come implementare il fulfillment mediante l'editor di Cloud Functions

Che cosa ti serve

Nel tuo ambiente devono essere presenti i seguenti strumenti:

• Un browser web, ad esempio Google Chrome

2. Configura

Le seguenti sezioni descrivono come configurare il tuo ambiente di sviluppo e creare il tuo progetto Actions.

Verifica le impostazioni delle autorizzazioni Google

Per testare l'azione che crei in questo codelab, devi abilitare le autorizzazioni necessarie affinché il simulatore possa accedere all'azione. Per attivare le autorizzazioni:

1. Vai alla pagina Gestione attività.
2. Se non l'hai già fatto, accedi con il tuo Account Google.
3. Abilita le seguenti autorizzazioni:

• Attività web e app
• Nella sezione Attività web e app, seleziona la casella di controllo Includi la cronologia di Chrome e le attività svolte su siti, app e dispositivi che usano i servizi Google.

crea un progetto Actions

Il progetto Actions è un container per la tua azione. Per creare il tuo progetto Actions per questo codelab, segui questi passaggi:

1. Apri la Console azioni.
2. Fai clic su Nuovo progetto.
3. Digita un nome del progetto, ad esempio actions-codelab. Il nome serve solo come riferimento interno. In seguito puoi impostare un nome esterno per il tuo progetto.

4. Fai clic su Crea progetto.
5. Nella schermata Che tipo di azione vuoi creare?, seleziona la scheda Personalizzata.
6. Tocca Avanti.
7. Seleziona la scheda Progetto vuoto.
8. Fai clic su Inizia la creazione.

Associare un account di fatturazione

Per eseguire il deployment del fulfillment in un secondo momento in questo codelab utilizzando Cloud Functions, devi associare un account di fatturazione al tuo progetto in Google Cloud.

Se non hai già associato un account di fatturazione al progetto, procedi nel seguente modo:

1. Vai alla pagina Fatturazione di Google Cloud Platform.
2. Fai clic su Aggiungi account di fatturazione o Crea account.
3. Inserisci i dati di pagamento.
4. Fai clic su Inizia la prova senza costi o su Invia e attiva la fatturazione.
5. Vai alla pagina Fatturazione di Google Cloud Platform.
6. Fai clic sulla scheda I miei progetti.
7. Fai clic sui tre puntini in Azioni accanto al progetto Actions per il codelab.
8. Fai clic su Modifica fatturazione.
9. Nel menu a discesa, seleziona l'account di fatturazione che hai configurato. Fai clic su Imposta account.

Per evitare che ti vengano addebitati dei costi, segui i passaggi descritti nella sezione Pulisci il progetto alla fine di questo codelab.

3. Comincia a parlarne

Gli utenti iniziano la conversazione con l'azione tramite chiamata. Ad esempio, se hai un'azione denominata MovieTime, gli utenti possono richiamarla pronunciando una frase come "Hey Google, talk to MovieTime, dove MovieTime è il nome visualizzato. L'azione deve avere un nome visualizzato se vuoi eseguirne il deployment in produzione; tuttavia, per testarla, non devi definirne il nome. In alternativa, puoi utilizzare l'espressione "Parla con la mia app di test" nel simulatore per richiamare l'azione.

Devi modificare la chiamata principale per definire cosa succede dopo che un utente richiama l'Azione.

Parole chiave:

• Chiamata principale: un punto di accesso per consentire agli utenti di avviare conversazioni con l'azione. Quando gli utenti pronunciano una frase simile a "Hey Google, parla con <nome visualizzato>", la chiamata principale si attiva e risponde all'utente.

Per impostazione predefinita, Actions Builder fornisce un messaggio generico quando viene attivata la chiamata ("Inizia a creare la tua azione definendo la chiamata principale.

Parole chiave:

• Prompt: indica ciò che l'azione invia agli utenti come risposta. I messaggi possono essere semplici risposte vocali e di testo o messaggi avanzati, come schede e immagini.

Puoi utilizzare un messaggio speciale, Canvas, per restituire all'utente elementi visivi a schermo intero. Per ulteriori informazioni su Canvas, consulta la sezione Canvas interattive.

Nella sezione successiva personalizzerai la richiesta della tua chiamata principale nella console di Actions.

Configura chiamata principale

Per modificare la richiesta che l'azione invia all'utente quando richiama l'azione:

1. Fai clic su Chiamata principale nella barra di navigazione.

2. Nell'editor di codice, sostituisci il testo nel campo speech (Start building your action...) con il seguente messaggio di benvenuto: A wondrous greeting, adventurer! Welcome to the mythical land of Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you're on your way to an epic journey.

Per modificare le richieste, puoi utilizzare la formattazione YAML o JSON.

3. Fai clic su Salva.

Testa la chiamata principale nel simulatore

La console di Actions fornisce uno strumento web per testare la tua azione denominata simulatore. L'interfaccia simula i dispositivi hardware e le relative impostazioni, in modo da consentirti di conversare con l'Azione come se fosse in esecuzione su uno smart display, un telefono, un altoparlante o KaiOS.

Per ulteriori informazioni sull'utilizzo del Simulatore della console di azioni, consulta Simulatore. Fai riferimento al problema se riscontri problemi seguendo i passaggi successivi.

Quando richiami l'azione, ora dovrebbe rispondere con il prompt personalizzato che hai aggiunto ("A wondrous greeting, adventurer!...").

Per testare la chiamata principale di Action nel simulatore:

1. Nella barra di navigazione in alto, fai clic su Test per accedere al simulatore.
2. Per richiamare l'Azione nel simulatore, digita Talk to my test app nel campo Input e premi Enter.

Puoi anche fare clic sul chip di suggerimento, Parla con la mia app di prova, oppure fare clic sull'icona del microfono e dire "Parla con la mia app di prova" per richiamare l'azione.

Quando attivi la chiamata principale di Action, l'assistente risponde con il tuo messaggio di benvenuto personalizzato. A questo punto, la conversazione termina dopo che l'assistente ha risposto con un saluto. Nella sezione successiva modificherai l'azione in modo che la conversazione continui.

Visualizza log eventi

Quando sei nella scheda Test, il riquadro a destra mostra i log eventi, che mostrano la cronologia delle conversazioni come log eventi. Ogni log eventi visualizza gli eventi che si verificano durante tale turno della conversazione.

Al momento l'Azione ha un unico log eventi, che mostra sia l'input dell'utente ("Talk to my test app") sia la tua risposta. Il seguente screenshot mostra il log eventi del tuo Action:

Se fai clic sulla Freccia giù nel log eventi, puoi vedere gli eventi, organizzati in ordine cronologico, che si sono verificati nel turno della conversazione:

• userInput: Corrisponde all'input dell'utente ("Talk to my test app").
• interactionMatch: Corrisponde alla risposta di chiamata principale dell'azione, attivata dall'input dell'utente. Se espandi questa riga facendo clic sulla freccia, puoi visualizzare la richiesta che hai aggiunto per la chiamata principale (A wondrous greeting, adventurer!...).
• endConversation: corrisponde alla transizione selezionata nell'intent Main invocation, che termina attualmente la conversazione. Per saperne di più sulle transizioni, consulta la prossima sezione di questo codelab.

I log eventi offrono visibilità sul funzionamento dell'azione e sono utili per eseguire il debug dell'azione in caso di problemi. Per visualizzare i dettagli di un evento, fai clic sulla freccia accanto al nome dell'evento, come mostrato nel seguente screenshot:

4. Crea la conversazione dell'azione

Ora che hai definito cosa succede dopo che un utente richiama l'azione, puoi creare il resto della conversazione. Prima di continuare con questo codelab, acquisisci familiarità con i termini seguenti per capire come funziona la conversazione relativa all'azione:

Parole chiave:

• Scena: un componente di base per l'azione che elabora l'input utente e in genere genera la risposta all'utente. L'intent degli utenti spesso attiva altre scene, che possono comunque essere attivate in altri modi.
• Intent dell'utente: definisce l'input utente comprensibile all'azione. Puoi definire le frasi di addestramento per questi intent. Quando gli utenti dicono qualcosa che corrisponde a o è simile a una frase di addestramento, viene cercata la corrispondenza con l'intent corrispondente.
• Frasi di addestramento: esempi di ciò che un utente potrebbe dire se corrisponde a un intent. Il motore per la comprensione del linguaggio naturale (NLU) dell'assistente espande in modo naturale queste frasi di addestramento per includere altre frasi simili.
• Transizione:definisce la scena a cui passare una volta soddisfatta la condizione.

L'azione può avere una o più scene e devi attivarle prima di eseguirle. L'azione che crei in questo codelab ha solo una scena intitolata: Start. Il modo più comune per attivare una scena è configurare l'azione in modo che, quando un utente corrisponde a un intent all'interno di una scena, l'intent attivi la transizione a un'altra scena e la attivi.

Ad esempio, immagina un'ipotetica azione che fornisca all'utente informazioni sugli animali. Quando l'utente richiama questa azione, l'intent Main invocation viene abbinato e attiva la transizione a una scena denominata Facts. Questa transizione attiva la scena Facts, che invia la seguente richiesta all'utente: Would you like to hear a fact about cats or dogs? All'interno della scena Facts c'è un intent utente chiamato Cat, che contiene frasi di addestramento che l'utente potrebbe dire per sentire un fatto di gatto, come "I want to sent a catfact." o "cat". Quando l'utente chiede di ascoltare un gatto, l'intent Cat viene trovato e attiva una transizione a una scena chiamata Cat fact. La scena Cat fact si attiva e invia una richiesta all'utente che include un fatto di gatto.

Figura 1. Il flusso di un tipico turno di conversazione in un'azione creata con Actions Builder

Insieme, scene, intenti e transizioni costituiscono la logica della conversazione e definiscono i vari percorsi che l'utente può intraprendere attraverso la conversazione di Action. Nella sezione seguente, crei una scena e definisci la modalità di attivazione di tale scena dopo che un utente richiama la tua azione.

Transizione dalla chiamata principale alla scena

In questa sezione creerai una nuova scena chiamata Start, che invia una richiesta all'utente per chiedere se vuole ricevere un messaggio della sua fortuna. Aggiungi anche una transizione dalla chiamata principale alla nuova scena Start.

Per creare la scena e aggiungervi una transizione, procedi nel seguente modo:

1. Fai clic su Sviluppo nella barra di navigazione.
2. Fai clic su Chiamata principale nella barra di navigazione laterale.
3. Nella sezione Transizione, fai clic sul menu a discesa e digita Start nel campo di testo.

4. Fai clic su Aggiungi. In questo modo, viene creata una scena chiamata Start che indica all'azione di passare alla scena Start dopo che l'Azione invia la richiesta di benvenuto all'utente.
5. Fai clic su Scene nella barra di navigazione laterale per visualizzare l'elenco delle scene.
6. Nella sezione Scene, fai clic su Avvia per visualizzare la scena di Start.
7. Fai clic su + nella sezione All'accesso della scena Start.
8. Seleziona Invia messaggi.
9. Sostituisci la frase nel campo speech (Enter the response that users will see or hear...) con una domanda da porre all'utente: Before you continue on your quest, would you like your fortune told?

10. Fai clic su Salva.

L'Assistente Google fornisce questo messaggio (Before you continue on your quest...) all'utente quando accede alla scena Start.

Aggiungi chip di suggerimenti

I chip di suggerimenti offrono suggerimenti cliccabili per l'utente, che vengono elaborati dalla tua azione come input. In questa sezione aggiungerai chip di suggerimenti per supportare gli utenti che utilizzano dispositivi con schermi.

Per aggiungere chip di suggerimenti alla richiesta di Start, segui questi passaggi:

1. Nella scena Start, fai clic su suggerimenti. Questa azione aggiunge un singolo chip di suggerimenti.
2. Nel campo title, sostituisci Suggested Response con 'Yes'.
3. Utilizzando la stessa formattazione, aggiungi manualmente un chip di suggerimento intitolato 'No'. Il tuo codice sarà simile al seguente snippet:

    suggestions:
      - title: 'Yes'
      - title: 'No'

4. Fai clic su Salva.

Verifica l'azione nel simulatore

A questo punto, l'Azione dovrebbe passare dalla chiamata principale alla scena Start e chiedere all'utente se vuole che la sua fortuna sia stata spiegata. I chip di suggerimenti dovrebbero essere visualizzati anche nel display simulato.

Per testare l'Azione nel simulatore, procedi nel seguente modo:

1. Nella barra di navigazione, fai clic su Test per accedere al simulatore.
2. Per testare l'Azione nel simulatore, digita Talk to my test app nel campo Input e premi Enter. L'azione dovrebbe rispondere con il messaggio Main invocation e il messaggio della scena Start aggiunto, "Before you continue on your quest, would you like your fortune told?".

Il seguente screenshot mostra questa interazione:

I log eventi registrano ogni interazione del simulatore nella sessione corrente, pertanto il log eventi dei test eseguiti in precedenza in questo codelab viene visualizzato come primo log eventi. Per cancellare i log degli eventi, fai clic su Reimposta test.

3. Fai clic sul chip di suggerimento Yes o No per rispondere alla richiesta. Puoi anche dire "Sì" o "No" o inserire Yes o No nel campo Input.

Quando rispondi alla richiesta, l'azione risponde con un messaggio che indica che non riesce a capire ciò che hai inserito: "No, non ho capito. Puoi riprovare?" Poiché non hai ancora configurato l'azione per capire e rispondere all'input "Sì o No, la tua azione corrisponderà all'input a un intent NO_MATCH.

Parole chiave:

• NO_MATCH: un intent catch-all che viene associato quando l'utente dice qualcosa che non può essere abbinato a un altro intent nella tua azione.
• Intent di sistema: un intent configurato per impostazione predefinita e che gestisce gli eventi di sistema comuni, ad esempio quando un utente non fornisce input. NO_MATCH e l'intent legato alla chiamata principale sono esempi di intent di sistema.

Per impostazione predefinita, l'intent di sistema di NO_MATCH fornisce risposte generiche, ma puoi personalizzarle per indicare all'utente che non hai capito. L'assistente termina la conversazione dell'utente con la tua azione dopo che non può corrispondere tre volte l'input utente.

Aggiungi intent yes e no

Ora che gli utenti possono rispondere alla domanda posta dall'azione, puoi configurare l'azione per comprendere le risposte degli utenti ("Sì" o "No"). Nelle sezioni seguenti, puoi creare intent che corrispondono a quando l'utente dice "Sì" o &Not e aggiungi questi intent alla scena Start.

Crea un intent yes

Per creare un intent yes, segui questi passaggi:

1. Fai clic su Sviluppo nella barra di navigazione.
2. Fai clic su Intent personalizzati nella barra di navigazione per aprire l'elenco di intent.
3. Fai clic su + (segno più) alla fine dell'elenco degli intent.
4. Assegna al nuovo intent il nome yes e premi Enter.
5. Fai clic sull'intent yes per aprire la pagina intent yes.
6. Nella sezione Aggiungi frasi di addestramento, fai clic sulla casella di testo Inserisci frase e inserisci le seguenti frasi:

• Yes
• Y
• I would
• Tell me

7. Fai clic su Salva.

Aggiungi un intent yes alla scena Start

Adesso l'Azione può capire quando un utente esprime il proprio intento "yes. Puoi aggiungere l'intent dell'utente yes alla scena Start perché l'utente sta rispondendo alla richiesta Start (prima di continuare con la Quest, vuoi che la tua fortuna sia dichiarata⁠quot;).

Per aggiungere l'intent dell'utente alla scena Start, segui questi passaggi:

1. Fai clic sulla scena Start nella barra di navigazione.
2. Fai clic sul segno + (più) nella scena Start accanto a Gestione intenti dell'utente.
3. Seleziona sì nel menu a discesa dell'intent.

4. Fai clic su Invia richieste e aggiorna il campo speech con il seguente testo: Your future depends on the aid you choose to use for your quest. Choose wisely! Farewell, stranger.

Il codice nell'editor dovrebbe essere simile al seguente snippet:

candidates:
  - first_simple:
      variants:
        - speech: >-
            Your future depends on the aid you choose to use for your quest. Choose
            wisely! Farewell, stranger.

5. Nella sezione Transizione, fai clic sul menu a discesa e seleziona Termina conversazione.
6. Fai clic su Salva.

Test yes intent nel simulatore

A questo punto, l'Azione capisce quando l'utente vuole ascoltare la sua fortuna e restituisce la risposta appropriata.

Per testare questo intent nel simulatore, segui questi passaggi:

1. Nella barra di navigazione, fai clic su Testa.
2. Per testare l'Azione nel simulatore, digita Talk to my test app nel campo Input e premi Enter.
3. Digita Yes nel campo Input e premi Enter. In alternativa, fai clic sul chip di suggerimento Sì.

L'azione risponde all'utente e gli comunica che la fortuna dipende dall'aiuto che sceglie. L'azione termina quindi la sessione perché hai selezionato la transizione End conversation per l'intent yes.

Crea un intent no

Ora devi creare l'intenzione no per comprendere e rispondere all'utente quando non vuole sentire la sua fortuna. Per creare questo intent, segui questi passaggi:

1. Fai clic su Sviluppo nella barra di navigazione.
2. Fai clic su Intent personalizzati nella barra di navigazione per aprire l'elenco di intent.
3. Fai clic su + (segno più) alla fine dell'elenco degli intent.
4. Assegna al nuovo intent il nome no e premi Enter.
5. Fai clic su no per aprire la pagina **no intent.
6. Nella sezione Aggiungi frasi di addestramento, fai clic sulla casella di testo Inserisci frase e inserisci le seguenti frasi:

• No
• N
• I don't want
• nope

7. Fai clic su Salva.

Aggiungi un intent no alla scena Start

Adesso l'Azione è in grado di capire quando un utente sta esprimendo "no" o qualcosa di simile a no, come no. Devi aggiungere l'intent dell'utente no alla scena Start perché l'utente sta rispondendo al messaggio Start (prima di continuare con la Quest, vuoi che la tua fortuna sia dichiarata⁠quot;).

Per aggiungere questo intent per la scena Start, segui questi passaggi:

1. Fai clic sulla scena Start nella barra di navigazione.
2. Fai clic sul + (segno più) nella scena Start accanto a Gestione intenti dell'utente.
3. Nella sezione Intent, seleziona no nel menu a discesa.

4. Fai clic su Invia messaggi.
5. Aggiorna il campo speech con il seguente testo: I understand, stranger. Best of luck on your quest! Farewell.

Il codice nell'editor dovrebbe essere simile al seguente snippet:

 candidates:
  - first_simple:
      variants:
        - speech: >-
             I understand, stranger. Best of luck on your quest! Farewell.

6. Nella sezione Transizione, seleziona Termina conversazione dal menu a discesa.
7. Fai clic su Salva.

Test no intent nel simulatore

A questo punto, l'Azione capisce quando l'utente non vuole ascoltare la sua fortuna e restituisce la risposta appropriata.

Per testare questo intent nel simulatore, segui questi passaggi:

1. Nella barra di navigazione, fai clic su Testa.
2. Digita Talk to my test app nel campo Input e premi Enter.
3. Digita No nel campo Input e premi Enter. In alternativa, fai clic sul chip di suggerimento No.

Invece di dare all'utente la sua fortuna, l'Azione gli augura un buon viaggio. L'azione termina quindi la sessione perché hai selezionato la transizione End conversation per l'intent no.

5. Implementazione del fulfillment

Attualmente, le tue risposte all'azione sono statiche; quando viene attivata una scena contenente un messaggio, l'azione invia la stessa richiesta ogni volta. In questa sezione implementi fulfillment che contiene la logica per creare una risposta dinamica conversazionale.

Parole chiave:

• Fulfillment: il codice che contiene la logica dell'azione. Un webhook attiva le chiamate al tuo fulfillment sulla base di eventi che si verificano all'interno delle tue Azioni.

Il tuo fulfillment identifica se l'utente è un utente di ritorno o un nuovo utente e modifica il messaggio di saluto dell'Azione per gli utenti di ritorno. Il messaggio di benvenuto viene abbreviato per gli utenti di ritorno e riconosce che il ritorno dell'utente è "Un saluto meraviglioso, avventuriero! Bentornato nella leggendaria terra di Gryffinberg!

Per questo codelab, utilizza l'editor di Cloud Functions nella console di Actions per modificare ed eseguire il deployment del codice di fulfillment.

Parole chiave:

• Editor di Cloud Functions: un editor integrato nella console di Actions, che puoi utilizzare per modificare ed eseguire il deployment del codice di fulfillment utilizzando Cloud Functions for Firebase.

L'azione può attivare webhook che comunicano l'evasione di un evento che si verifica durante una chiamata o parti specifiche di un'esecuzione di scena. Quando viene attivato un webhook, l'azione invia al tuo fulfillment una richiesta con payload JSON, insieme al nome del gestore da utilizzare per elaborare l'evento. Questo gestore esegue una logica e restituisce una risposta JSON corrispondente.

Crea il tuo fulfillment

Ora puoi modificare il fulfillment nell'editor incorporato per generare richieste diverse per gli utenti di ritorno e per i nuovi utenti quando richiamano la tua Azione.

Per aggiungere questa logica al fulfillment, procedi nel seguente modo:

1. Fai clic su Sviluppo nella barra di navigazione.
2. Fai clic sulla scheda Webhook nella barra di navigazione.
3. Seleziona la casella di controllo Inline Cloud Functions.
4. Fai clic su Conferma. Il codice boilerplate viene aggiunto automaticamente per i file index.js e package.json.

5. Sostituisci i contenuti di index.js con il seguente codice:

index.js

const { conversation } = require('@assistant/conversation');
const functions = require('firebase-functions');

const app = conversation({debug: true});

app.handle('greeting', conv => {
 let message = 'A wondrous greeting, adventurer! Welcome back to the mythical land of Gryffinberg!';
 if (!conv.user.lastSeenTime) {
   message = 'Welcome to the mythical land of  Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you\'re on your way to an epic journey.';
 }
 conv.add(message);
});


exports.ActionsOnGoogleFulfillment = functions.https.onRequest(app);

5. Fai clic su Salva completamento.
6. Fai clic su Deploy Fulfillment.

Attendi alcuni minuti affinché Cloud Functions esegua il provisioning e il deployment del fulfillment. Dovresti visualizzare un messaggio Deployment Cloud Function in progress... sopra l'editor di codice. Una volta eseguito il deployment del codice, il messaggio viene aggiornato in Il deployment della funzione Cloud Functions è aggiornato.

Comprendere il codice

Il tuo fulfillment, che utilizza la libreria Actions on Google per il completamento di Node.js, risponde alle richieste HTTP dall'Assistente Google.

Nello snippet di codice precedente, definisci il gestore greeting, che verifica se l'utente ha precedentemente visitato l'azione controllando la proprietà lastSeenTime. Se lastSeenTime non è definito, l'utente è nuovo e il gestore greeting fornisce il saluto dell'utente.

Aggiorna la chiamata principale per attivare un webhook

Ora che hai definito la funzione greeting, puoi configurare il gestore di eventi greeting nel tuo intent di chiamata principale in modo che l'azione possa chiamare questa funzione quando l'utente richiama l'azione.

Per configurare l'azione in modo che chiami il nuovo gestore greeting, segui questi passaggi:

1. Fai clic su Chiamata principale nella barra di navigazione.
2. Cancella Invia messaggio.
3. Seleziona la casella di controllo Chiama il tuo webhook.
4. Aggiungi greeting nella casella di testo.

5. Fai clic su Salva.

Testa la chiamata principale aggiornata nel simulatore

Per testare l'Azione nel simulatore, procedi nel seguente modo:

1. Nella barra di navigazione, fai clic su Test per accedere al simulatore.
2. Digita Talk to my test app nel campo Input e premi Enter.

Poiché hai testato la tua azione in precedenza in questo codelab, non sei un nuovo utente e per questo motivo ricevi il seguente messaggio di benvenuto abbreviato: "Un saluto meraviglioso, avventuroso! Bentornato nella leggendaria terra di Gryffinberg!..."

Ripulire il progetto [consigliato]

Il codelab di livello 2, Build Actions for Google Assistant using Actions Builder (Level 2), crea il progetto creato in questo codelab. Se hai intenzione di fare il codelab di livello 2, non eliminare il progetto; puoi eliminarlo nella sezione Pulizia del progetto alla fine del codelab di livello 2.

Per evitare che non vengano addebitati costi, ti consigliamo di rimuovere i progetti che non intendi utilizzare. Per eliminare i progetti creati in questo codelab, segui questi passaggi:

1. Per eliminare il progetto cloud e le risorse, completa i passaggi elencati nella sezione Arresto (eliminazione) dei progetti.

Assicurati di selezionare il progetto corretto da eliminare nella pagina Impostazioni di Google Cloud Platform.

2. (Facoltativo) Per rimuovere immediatamente il progetto dalla Console Azioni, completa i passaggi elencati nella sezione Eliminare un progetto. Se non completi questo passaggio, il tuo progetto verrà rimosso automaticamente dopo circa 30 giorni.

6. Complimenti!

Hai appreso le nozioni di base della creazione di Azioni per l'Assistente Google.

Argomenti trattati

• Come configurare un progetto Actions con la console di Actions
• Come aggiungere un messaggio alla chiamata principale in modo che gli utenti possano avviare una conversazione con l'azione
• Come creare un'interfaccia di conversazione con scene, intent, transizioni, chip di suggerimenti e fulfillment
• Come testare l'Azione con il Simulatore delle azioni

Scopri di più

Consulta le seguenti risorse per saperne di più sulla creazione di Azioni per l'Assistente Google:

• Crea Azioni per l'Assistente Google utilizzando il codelab di Builder di Azioni (livello 2) per continuare a creare la tua azione di conversazione da questo codelab
• Il sito ufficiale della documentazione sullo sviluppo di Actions for Google Assistant
• Azioni nella pagina Google GitHub per codice di esempio e librerie
• La community ufficiale di Reddit per gli sviluppatori che lavorano con l'assistente
• @ActionOnGoogle su Twitter per gli ultimi annunci (tweet con #AoGDevs per condividere ciò che crei)

Sondaggio di feedback

Prima di terminare, compila un breve sondaggio sulla tua esperienza.