Guida rapida all'SDK di Actions e a Builder

Questa guida illustra come configurare l'ambiente per creare Azioni utilizzando sia l'SDK Actions sia l'Action Builder. Dovrai svolgere le seguenti attività:

  • Installa Node.js: è necessario questo ambiente di runtime per utilizzare Node.js nella libreria di distribuzione.
  • Installa l'interfaccia a riga di comando di Firebase: questo strumento a riga di comando consente di sviluppare e eseguire il deployment delle dipendenze Firebase, ad esempio le app web per Interactive Canvas, Firebase Hosting.
  • Installa lo strumento a riga di comando gactions: durante lo sviluppo con Actions utilizzare questo strumento per creare, gestire e implementare il pacchetto Action l'Azione.
  • Crea un progetto Actions: un progetto Actions è il container logico. per le Azioni conversazionali. Devi crearne uno nella console Actions prima di possono iniziare a creare.
  • Inizializza ed esegui il deployment di un esempio: questo semplice esempio mostra come ottenere ha iniziato a creare Azioni con Interactive Canvas.

Una volta completata questa guida rapida, puoi sincronizzare il tuo progetto Actions tra il tuo ambiente di sviluppo locale e l'esperienza web di Actions Builder.

Installare Node.js e l'interfaccia a riga di comando di Firebase

Scarica e installa Node.js in base al file Node.js per utilizzare la nostra libreria di distribuzione. L'installazione di Node.js ti consente di installare l'interfaccia a riga di comando di Firebase con npm e, in un secondo momento, per eseguire il completamento delle conversazioni a livello locale.

Installa e configura l'interfaccia a riga di comando di Firebase in base alle alla documentazione di Firebase. L'interfaccia a riga di comando di Firebase ti consente di eseguire il deployment Canvas dell'app web in Firebase Hosting e, se necessario, esegui il deployment manuale il deployment a Cloud Functions for Firebase.

Installa lo strumento a riga di comando gactions

Installa lo strumento di interfaccia a riga di comando (CLI) di gactions scaricando un di installazione del pacchetto, decomprimerlo e configurare il percorso di esecuzione.

Per installare e configurare i gruppi, segui questi passaggi:

  1. Scarica il pacchetto appropriato per il tuo sistema operativo:

    Piattaforma Pacchetto Checksum
    Windows Scarica SHA256
    Linux Scarica SHA256
    Sistema operativo Mac Scarica SHA256

  2. Estrai il pacchetto in una posizione a tua scelta e aggiungi il file binario al tuo la variabile PATH dell'ambiente. In alternativa, estrai il pacchetto località già presente nella variabile PATH (ad es. /usr/local/bin).

  3. Su Linux e Mac, abilita le autorizzazioni di esecuzione se necessario:

    chmod +x PATH_TO/gactions

  4. Esegui questo comando per autenticare l'interfaccia a riga di comando. Questo comando avvia un flusso di autenticazione e richiede un browser web:

    gactions login

    Al termine del flusso, l'interfaccia a riga di comando esegue automaticamente l'autenticazione.

Creare e configurare un progetto

Prima di poter utilizzare lo strumento a riga di comando gactions, devi creare un progetto in la console Azioni e concedere ai gazioni l'accesso al progetto. Per creare e impostare per creare un progetto, segui questi passaggi:

  1. Vai alla console Actions.
  2. Fai clic su Nuovo progetto, inserisci un nome per il progetto e fai clic su Crea progetto.
  3. Seleziona una categoria e fai clic su Avanti.
  4. Seleziona Progetto vuoto e fai clic su Inizia a creare.
  5. Abilita l'API Actions nella console Google Cloud seguendo le istruzioni in Attivare e disattivare di terze parti. In questo modo i gazioni possono interagire con il tuo progetto.

Ottieni l'esempio di Hello World

L'esempio interattivo Hello World mostra come creare un'azione semplice progetto con una singola azione basata su Interactive Canvas.

  1. Crea una directory vuota e inizializza l'esempio di Canvas interattivo in quella directory. Ad esempio, il seguente codice inizializza l'esempio in una Directory interactive-canvas-sample/, utilizzata come esempio in questo documento:

    gactions init interactive-canvas --dest interactive-canvas-sample
cd interactive-canvas-sample

  2. Apri il file interactive-canvas-sample/sdk/settings/settings.yaml e cambia il valore del campo projectId nell'ID del tuo progetto.

Esegui il deployment dell'esempio e testalo

Dopo aver configurato l'esempio, puoi eseguire il deployment dell'app web Interactive Canvas e il tuo progetto Actions. Questo processo crea una versione bozza delle azioni di cui puoi eseguire il deployment nel simulatore di Actions per l'anteprima e il test:

  1. Dalla directory interactive-canvas-sample/, esegui questo comando per eseguire il deployment dell'app web Interactive Canvas (i contenuti dei tag public/ ).

    firebase deploy --project PROJECT_ID --only hosting

    Puoi vedere una versione sottoposta a rendering dell'app web all'URL restituito dal Interfaccia a riga di comando di Firebase in un browser: https://PROJECT_ID.web.app.

  2. Apri il file interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js e Sostituisci il valore della variabile CANVAS_URL con l'URL dell'app web del tuo progetto.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';

  3. Dalla directory interactive-canvas-sample/sdk/, esegui questo comando per eseguire il push della versione locale del tuo progetto Actions alla console come versione bozza:

    gactions push

  4. Dalla directory interactive-canvas-sample/sdk/, esegui questo comando per testare il tuo progetto Actions nel simulatore:

    gactions deploy preview

  5. Apri il link restituito dallo strumento a riga di comando per accedere al simulatore.

  6. Nel simulatore, inserisci "Parla con l'esempio della tela interattiva" per avviare l'azione. Tu dovrebbe essere visualizzato un triangolo rotante basato sull'applicazione web di cui è stato eseguito il deployment https://PROJECT_ID.web.app

    Figura 1. Il simulatore che visualizza l'anteprima del progetto Actions
    .