Crea il tuo primo agente

Prerequisiti

Crea il tuo agente

Questa guida illustra come creare un agente utilizzando un'applicazione di esempio. L'esempio fornisce un modo rapido per esplorare la funzionalità di un agente e può fungere da punto di partenza per lo sviluppo dell'agente. Se vuoi modificare un'applicazione esistente per includere un agente, l'esempio offre un buon modello per la logica dell'applicazione.

In questa guida rapida, procedi come segue:

  • Registrati come partner
  • Crea un brand e un agente
  • Facoltativamente, esplora le funzionalità in una conversazione con il bot Business Messages Helper
  • Configura l'agente per inviare e ricevere messaggi

Per creare un agente senza utilizzare l'esempio, vedi Creare l'agente.

Registrati come partner

  1. Apri la Console per gli sviluppatori di Business Communications.
  2. Nella sezione Messaggi delle attività, fai clic su Crea account partner.

  3. Inserisci le informazioni sul partner:

    Campo Valore
    Il tuo nome Il tuo nome completo
    Nome partner Nome della tua organizzazione
    Sito web partner Sito web della tua organizzazione
    Regione La regione in cui vuoi ospitare il servizio Business Messages

  4. Leggi e accetta i Termini di servizio di Business Messages.

  5. Fai clic su Crea.

Ora hai effettuato la registrazione come partner di Business Messages. È stato creato un nuovo progetto Google Cloud con le API Business Messages e Business Communications attivate. Non hai accesso a questo progetto e questo non interferirà con i progetti Google Cloud esistenti.

Ora hai accesso alle API Business Messages e Business Communications.

Crea un account di servizio

  1. Nella home page della Console per gli sviluppatori delle comunicazioni aziendali, fai clic su Impostazioni account partner.
  2. Nel menu di navigazione a sinistra, fai clic su Account di servizio.

  3. Fai clic su Crea chiave, quindi su Crea.

    Il browser scarica la chiave dell'account di servizio. Conservalo in un luogo sicuro. Questa chiave ti servirà in un secondo momento per eseguire il deployment di un'applicazione web e per accedere alle API Business Messages e Business Communications in futuro.

Crea un brand e un agente

Un agente è una rappresentazione colloquiale di un brand, l'entità conversazionale con cui gli utenti interagiscono. Crei un brand per rappresentare l'attività e un agente per consentire ai consumatori di entrarvi in contatto.

  1. Apri la Business Communications Developer Console e accedi con il tuo Account Google Business Messages.
  2. Fai clic su Crea agente.
  3. In Tipo di agente, seleziona Messaggi dell'attività.
  4. Inserisci i valori per Nome brand e Nome agente.
  5. Esegui una delle seguenti operazioni:
    • Per partecipare a una conversazione con il tuo agente in cui esplorare le funzionalità disponibili, seleziona Attiva il bot Business Messages Helper.
    • Per personalizzare l'agente e prepararlo per la gestione dei messaggi, deseleziona Attiva il bot Business Messages Helper.
  6. Fai clic su Crea agente.

Se hai attivato il bot Business Messages Helper, puoi avviare immediatamente una conversazione. In caso contrario, procedi alla configurazione dell'agente per la gestione dei messaggi.

Esplorare le funzionalità con il bot Business Messages Helper

Il bot Business Messages Helper ti consente di avviare rapidamente una conversazione con il tuo agente, così puoi scoprire cosa offre la piattaforma. L'attivazione del bot Helper è facoltativa, ma vivamente consigliata durante la creazione del primo agente.

Il bot Helper ti consente di

  • Esplora le funzionalità avanzate
  • Scopri come implementare le funzionalità
  • Trova risorse per la configurazione dell'agente

Quando è attivato, il bot Helper invia e riceve messaggi per conto del tuo agente; non è necessario alcun webhook. Devi disabilitare il bot Helper prima di poter impostare un webhook o attivare Dialogflow per gestire i messaggi per gli utenti.

Avviare una conversazione con il bot Helper

Una volta attivato il bot Business Messages Helper, potrai iniziare una conversazione. Al termine della creazione dell'agente si apre una finestra di dialogo per aiutarti a iniziare.

Per interagire con il bot Helper, segui questi passaggi da questa finestra di dialogo:

  1. Accedi agli URL di test dell'agente. Puoi farlo in uno dei seguenti modi:

    • Fai clic sul pulsante Android o iOS. Quindi scansiona il codice QR con il dispositivo mobile corrispondente e fai clic su Avvia. In alternativa, fai clic su Copia URL Android o Copia URL iOS per copiare l'URL di test dell'agente.
    • Fai clic su Invia per inviare gli URL al tuo indirizzo email.

  2. Apri l'URL nel tuo dispositivo mobile. I dispositivi iOS richiedono l'app Google Maps.

Disattiva il bot Helper

Prima di poter personalizzare l'agente e prepararlo al lancio, devi disattivare il bot Business Messages Helper.

Per disattivare il bot Helper,

  1. Apri la Business Communications Developer Console.
  2. Seleziona il tuo agente.
  3. Nel menu di navigazione a sinistra, fai clic su Integrazioni.
  4. In Bot Helper, fai clic su Disattiva.

Quando è disattivato, il bot Helper non invia e riceve più messaggi per l'agente. Ora puoi configurare il tuo agente per gestire il flusso di messaggistica.

Configura l'agente per la gestione dei messaggi

In questa guida, eseguirai il deployment di un Echo Bot in Google Cloud Platform (GCP) con un webhook progettato per elaborare i messaggi per gli utenti.

Il bot Echo è un'applicazione di esempio che riporta i messaggi all'utente. Ti consente di sperimentare funzionalità avanzate, come le azioni suggerite e le schede interattive, in una conversazione con il tuo agente. Puoi utilizzare l'Echo Bot come punto di partenza per lo sviluppo dell'agente.

Devi completare i seguenti passaggi:

  • Deployment dell'esempio di Echo Bot su GCP
  • Configura l'URL webhook per il tuo account partner di Business Messages
  • Fornisci informazioni di base sull'agente

Al termine di questa guida, il tuo agente sarà pronto a inviare e ricevere messaggi.

Esegui il deployment dell'applicazione web in GCP

Business Messages inoltra i messaggi degli utenti a un webhook nella tua infrastruttura. In questa guida, eseguirai il deployment del codice sorgente di esempio del bot Echo in un webhook preconfigurato. Se hai già un'infrastruttura web per sfruttare la ricezione dei messaggi, puoi creare un nuovo webhook nel servizio web, ma dovrai configurare personalmente la logica. Per maggiori dettagli, consulta Impostare il webhook a livello di partner.

Crea un ambiente Cloud

È necessario un ambiente cloud per eseguire il deployment dell'esempio Echo Bot.

Per creare un progetto GCP come ambiente cloud, segui questi passaggi:

  1. Apri il selettore di progetti della console Google Cloud.

    Se non hai mai creato un progetto Google Cloud, devi accettare i Termini e i Servizi.

  2. Fai clic su Crea progetto.

  3. Inserisci un nome e una località per il nuovo progetto

    • L'ID progetto viene generato automaticamente e viene visualizzato sotto il nome del progetto.
    • Nel campo Località, fai clic su Sfoglia per visualizzare le potenziali località per il tuo progetto. Se non riesci a trovare la tua organizzazione Google Workspace, significa che non hai eseguito l'accesso a un account Google Workspace. Puoi creare un progetto senza un'organizzazione, ma alcune funzionalità sono limitate. Per saperne di più, vedi Vantaggi della risorsa organizzazione.

  4. Fai clic su Crea.

  5. Fai clic su Menu.

  6. Fai clic su Fatturazione.

  7. Fai clic su Collega un account di fatturazione.

  8. Crea un nuovo account di fatturazione o aggiungi un account di fatturazione esistente al progetto. Vedi le Funzionalità del programma Google Cloud Free per comprendere le opzioni di pagamento.

Esegui il deployment dell'esempio di Echo Bot

  1. Installa l'interfaccia a riga di comando gcloud. Lo utilizzerai per eseguire il deployment del codice campione su Google Cloud.

  2. Scarica ed estrai l'esempio di Echo Bot (Node.js, Java, Python).

  3. Copia il file delle credenziali JSON scaricato in Crea un account di servizio nella cartella delle risorse dell'esempio e rinomina le credenziali in "bm-agent-service-account-credentials.json". Il percorso a questo file delle credenziali dipende dall'esempio scaricato.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. In un terminale, vai alla directory full_sample dell'esempio.

  5. Esegui questi comandi in un terminale per eseguire il deployment dell'esempio:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID è l'ID del progetto che hai creato in Creare un ambiente Cloud. L'ID progetto è elencato nella dashboard del progetto in Google Cloud.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID è l'ID del progetto che hai creato in Creare un ambiente Cloud. L'ID progetto è elencato nella dashboard del progetto in Google Cloud.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID è l'ID del progetto che hai creato in Creare un ambiente Cloud. L'ID progetto è elencato nella dashboard del progetto in Google Cloud.

  6. Prendi nota dell'URL dell'applicazione di cui hai eseguito il deployment nell'output dell'ultimo comando. Questa è la base dell'URL webhook:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

Imposta il webhook

Ora che hai eseguito il deployment dell'Echo Bot, devi specificare un URL webhook (che operi) per iniziare a ricevere i messaggi.

  1. Apri le Impostazioni account nella Developer Console di Business Communications.
  2. Assicurati che sia selezionato l'account partner corretto.
  3. In URL webhook di Business Messages, fai clic su Configura.

  4. In URL endpoint webhook, inserisci l'URL dell'applicazione + "/callback".

    Il formato dell'endpoint avrà il seguente formato: "https://PROJECT_ID.appspot.com/callback".

    Questo endpoint è predefinito nella logica dell'applicazione del campione di cui hai eseguito il deployment in GCP.

  5. Nella Console per gli sviluppatori, fai clic su Verifica.

    Quando Business Messages verifica il webhook, la finestra di dialogo si chiude.

Per configurare il webhook con l'API Business Communications, consulta Esempio: aggiornamento dell'URL webhook.

Puoi utilizzare il framework di test di Business Messages per verificare se il tuo webhook risponde correttamente ai payload di Business Messages.

Inserisci le informazioni dell'agente

Fornisci alcune informazioni di base per completare la configurazione dell'agente.

  1. Apri la Business Communications Developer Console.
  2. Nel menu di navigazione a sinistra, fai clic su Informazioni agente.

  3. Aggiorna i valori come preferisci o utilizza i suggerimenti seguenti:

    Campo Valore
    Messaggio di benvenuto Ti diamo il benvenuto alla conversazione Echo Bot.
    Norme sulla privacy https://policies.google.com/privacy

  4. Fai clic su Salva.

Avvia la conversazione

Per interagire con l'Echo Bot, segui questi passaggi:

  1. Apri la Business Communications Developer Console.
  2. Nel menu di navigazione a sinistra, fai clic su Informazioni agente.
  3. In URL di test dell'agente, fai clic sul pulsante Android o iOS.

  4. Scansiona il codice QR con il dispositivo mobile corrispondente oppure fai clic su Copia URL Android o Copia URL iOS per copiare l'URL di test dell'agente.

    Puoi anche fare clic su Invia per inviare gli URL al tuo indirizzo email.

  5. Apri l'URL nel tuo dispositivo mobile. I dispositivi iOS richiedono l'app Google Maps.

Il messaggio di benvenuto del tuo agente ti saluta. A questo punto, puoi interagire con l'Echo Bot. Fa eco al tuo messaggio. Inoltre, puoi richiamare funzionalità avanzate inviando stringhe specifiche: "carosello", "scheda", "chip".

Passaggi successivi

Ora che hai creato il tuo primo agente, scopri di più su Business Messages e su cos'altro puoi fare sulla piattaforma.