Crea il tuo primo agente

Prerequisiti

crea il tuo agente

Questa guida ti mostra come creare un agente utilizzando un'applicazione di esempio. Il campione 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 imparerai a:

  • Registrati come partner
  • Crea un brand e un agente
  • (Facoltativo) Esplora le funzionalità in una conversazione con il bot Business Messages Helper
  • Configurare l'agente per inviare e ricevere messaggi

Per creare un agente senza utilizzare l'esempio, consulta Crea il tuo agente.

Registrati come partner

  1. Apri la Business Communications Developer Console.
  2. In Business Messages, fai clic su Crea account partner.

  3. Inserisci i dati 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.

Ora sei registrato come partner di Business Messages. È stato creato un nuovo progetto Google Cloud con le API Business Messages e Business Communications abilitate. Non hai accesso a questo progetto e non interferirà con nessuno dei tuoi progetti Google Cloud esistenti.

Ora hai accesso alle API Business Messages e Business Communications.

Crea un account di servizio

  1. Nella home page della 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 del service account. Conservalo in una posizione sicura. 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 è una rappresentazione colloquiale di un brand, ovvero l'entità conversazionale con cui gli utenti interagiscono. Crea un brand per rappresentare l'attività e un agente in modo che i consumatori possano interagire con lui in modo conversazionale.

  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 Business Messages.
  4. Inserisci i valori per Nome brand e Nome agente.
  5. Esegui una delle seguenti operazioni:
    • Per provare 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 alla 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 subito una conversazione. In caso contrario, vai a configurare l'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 di assistenza è facoltativa, ma vivamente consigliata quando crei il tuo primo agente.

Il Bot Helper ti consente di

  • Esplorare le funzionalità avanzate
  • Scopri come implementare le funzionalità
  • Trovare risorse per la configurazione degli agenti

Quando è attivato, il bot Helper 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 attivare 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. Esistono diversi modi per farlo:

    • 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 sul tuo dispositivo mobile. (I dispositivi iOS richiedono l'app Google Maps.)

Disattivare il bot Helper

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 Business Communications Developer Console.
  2. Seleziona l'agente.
  3. Nel riquadro di navigazione a sinistra, fai clic su Integrazioni.
  4. Per Bot Helper, fai clic su Disattiva.

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

Configurare l'agente per la gestione dei messaggi

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

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

Completa i seguenti passaggi:

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

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

Esegui il deployment dell'applicazione web su 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 di Echo Bot in un webhook preconfigurato. Se hai già un'infrastruttura web da sfruttare per ricevere i 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 GCP come ambiente cloud:

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

    Se non hai mai creato un progetto Google Cloud, devi accettare i Termini di servizio.

  2. Fai clic su Crea progetto.

  3. Inserisci un nome e una posizione per il nuovo progetto

    • L'ID progetto viene generato automaticamente e visualizzato sotto il nome del progetto.
    • Nel campo Posizione, fai clic su Sfoglia per visualizzare le potenziali posizioni 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ù, consulta la sezione Vantaggi della risorsa dell'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 programma Google Cloud Free Funzionalità per comprendere le opzioni di pagamento.

Esegui il deployment dell'esempio Echo Bot

  1. Installa gcloud CLI. Lo 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 service account 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 dal campione che hai 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 progetto del progetto che hai creato in Crea 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 progetto del progetto che hai creato in Crea 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 progetto del progetto che hai creato in Crea 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 Echo Bot è stato implementato, devi specificare un URL webhook (che gestisci) per iniziare a ricevere messaggi.

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

  4. In Webhook endpoint URL (URL endpoint webhook), inserisci l'URL della tua applicazione + "/callback".

    L'endpoint seguirà il formato: "https://PROJECT_ID.appspot.com/callback".

    Questo endpoint è predefinito nella logica dell'applicazione dell'esempio che hai eseguito il deployment su GCP.

  5. In Developer Console, 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: aggiorna l'URL webhook.

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

Inserisci i dati 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 sull'agente.

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

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

  4. Fai clic su Salva.

Avvia la conversazione

Per interagire con Echo Bot:

  1. Apri la Business Communications Developer Console.
  2. Nel menu di navigazione a sinistra, fai clic su Informazioni sull'agente.
  3. Nella sezione 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 sul tuo dispositivo mobile. (I dispositivi iOS richiedono l'app Google Maps.)

Il messaggio di benvenuto dell'agente ti saluta. A questo punto, puoi interagire con l'Echo Bot. Ripete i messaggi che invii. 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.