Crea il tuo primo agente

Prerequisiti

Crea l'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ò servire come punto di partenza per lo sviluppo dell'agente. Se vuoi modificare un'applicazione esistente in modo da includere un agente, l'esempio offre un modello appropriato per la logica dell'applicazione.

In questa guida rapida, imparerai a:

  • Registrati come partner
  • Crea un brand e un agente
  • Se vuoi, esplora le funzionalità in una conversazione con il bot Business Messages Helper
  • Configura l'agente per l'invio e la ricezione di messaggi

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

Registrati come partner

  1. Apri la Console per gli sviluppatori di Business Communications.
  2. In Business Messages, fai clic su Crea account partner.

  3. Inserisci le informazioni del 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.

Hai effettuato la registrazione come partner Business Messages. È stato creato per te un nuovo progetto Google Cloud con le API Business Messages e Business Communications abilitate. Non hai accesso a questo progetto, che non interferirà con nessuno dei tuoi progetti Google Cloud esistenti.

Ora hai accesso alle API Business Messages e Business Communications.

Crea un service account

  1. Nella home page di Business Communications Developer Console, 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. Avrai bisogno di questa chiave in un secondo momento per eseguire il deployment di un'applicazione web e accedere alle API Business Messages e Business Communications in futuro.

Crea un brand e un agente

Un agente è la rappresentazione conversazionale di un brand, l'entità conversazionale con cui interagiscono gli utenti. Crei un brand per rappresentare l'attività e crei un agente in modo che i consumatori possano interagire.

  1. Apri la Console per gli sviluppatori di Business Communications e accedi con il tuo Account Google Business Messages.
  2. Fai clic su Crea agente.
  3. In Tipo di agente, seleziona Business Messages.
  4. Inserisci i valori per Nome del brand e Nome agente.
  5. Esegui una delle seguenti operazioni:
    • Per avviare una conversazione con il tuo agente in cui puoi 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 una conversazione immediatamente. In caso contrario, procedi alla configurazione dell'agente per la gestione dei messaggi.

Esplora le funzionalità con il bot Business Messages Helper

Il bot Business Messages Helper ti consente di avviare rapidamente una conversazione con il tuo agente per scoprire cosa offre la piattaforma. L'abilitazione del bot Helper è facoltativa, ma vivamente consigliata durante la creazione del tuo 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 il bot Helper è attivato, invia e riceve messaggi per conto del tuo agente; non è necessario alcun webhook. Devi disattivare il bot Helper prima di poter impostare un webhook o abilitare Dialogflow per gestire i messaggi degli utenti.

Avviare una conversazione con il bot Helper

Dopo aver attivato il bot Business Messages Helper, puoi avviare una conversazione. Subito dopo la 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 diversi modi:

    • Fai clic sul pulsante Android o iOS. Scansiona quindi 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 del test dell'agente.
    • Fai clic su Invia per inviare gli URL al tuo indirizzo email.

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

Disattiva il bot Assistente

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

Per disattivare il bot Helper:

  1. Apri la Console per gli sviluppatori di Business Communications.
  2. Seleziona l'agente.
  3. Nel menu di navigazione a sinistra, fai clic su Integrazioni.
  4. In corrispondenza di Bot Helper, fai clic su Disattiva.

Quando il bot Helper è disattivato, non invia e riceve più messaggi per l'agente. Ora puoi impostare l'agente per la gestione del flusso di messaggi.

Configura l'agente per la gestione dei messaggi

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

Il bot Echo è un'applicazione di esempio che invia i messaggi all'utente. Ti consente di sperimentare funzionalità avanzate, come azioni suggerite e schede informative, in una conversazione con il tuo agente. Puoi anche usare Echo Bot come punto di partenza per sviluppare l'agente.

Devi completare questi passaggi:

  • Esegui il deployment dell'esempio di Echo Bot su Google Cloud
  • Configura l'URL webhook per l'account partner Business Messages
  • Fornisci informazioni di base sull'agente

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

Esegui il deployment dell'applicazione web in Google Cloud

Business Messages inoltra i messaggi dagli 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 disponi già di un'infrastruttura web che ti consente di ricevere messaggi, puoi creare un nuovo webhook su quel servizio web, ma dovrai configurare la logica autonomamente. Per maggiori dettagli, consulta Impostare il webhook a livello di partner.

crea un ambiente cloud

Per eseguire il deployment dell'esempio di Echo Bot è necessario un ambiente cloud.

Per creare un progetto Google Cloud 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, dovrai accettare i Termini e 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 località potenziali per il 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ù, consulta 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 aggiungine uno esistente al progetto. Consulta Funzionalità del programma senza costi di Google Cloud per conoscere le opzioni di pagamento.

Esegui il deployment dell'esempio di Bot Echo

  1. Installa gcloud CLI. che utilizzerai per eseguire il deployment del codice campione in 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 di 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 del Sample.

  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 è stato 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 di Echo Bot, devi specificare l'URL webhook (che utilizzi) per iniziare a ricevere messaggi.

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

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

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

    Questo endpoint è predefinito nella logica dell'applicazione dell'esempio di cui hai eseguito il deployment in Google Cloud.

  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 del webhook.

Puoi utilizzare il framework di test di Business Messages per verificare se il 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 Console per gli sviluppatori di Business Communications.
  2. Nel menu di navigazione a sinistra, fai clic su Informazioni agente.

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

    Campo Valore
    Messaggio di benvenuto Ti diamo il benvenuto alla conversazione su 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 Console per gli sviluppatori di Business Communications.
  2. Nel menu di navigazione a sinistra, fai clic su Informazioni agente.
  3. Nella sezione URL test 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 del test dell'agente.

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

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

Il messaggio di benvenuto dell'agente ti saluta. A questo punto, puoi interagire con il bot Echo. fa eco ai messaggi che ti rispedisci. 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 cos'altro puoi fare sulla piattaforma.