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, puoi esplorare le funzionalità di una conversazione con Business Messages Bot 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 l'app 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 account di servizio

  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 in ogni località. Ti servirà in un secondo momento per eseguire il deployment di un'applicazione web 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. Tu crei un brand per rappresentare l'attività e creare un agente, in modo che i consumatori possano conversare con l'azienda in modo conversazionale.

  1. Apri lo Sviluppatore di comunicazioni aziendali 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 del brand e Nome agente.
  5. Esegui una delle seguenti operazioni:
    • Per affrontare una conversazione con il tuo agente e approfondire 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. Altrimenti, procedi con la 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 per permetterti di sperimentare ciò che la piattaforma ha da offrire. Attivazione dell'helper Il bot è facoltativo, ma vivamente consigliato quando crei il 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 dell'agente. non è richiesto 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. Per farlo, hai a disposizione le seguenti opzioni:

    • 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 copiarlo. l'URL di 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 Google Maps app.)

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 lo Sviluppatore di comunicazioni aziendali Google Cloud.
  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 configurare l'agente affinché gestisca flusso di messaggistica.

Configura l'agente per la gestione dei messaggi

In questa guida, eseguirai il deployment di un bot Echo 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. it ti consente di sperimentare funzionalità avanzate, come azioni suggerite e schede informative, in una conversazione con l'agente. Puoi anche usare il bot Echo 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 degli utenti a un webhook nella tua infrastruttura. In questa guida, utilizzerai l'esempio di Bot Echo a un webhook preconfigurato. Se hai già un'infrastruttura web per ricevere messaggi, puoi creare un nuovo webhook sul web ma dovrai configurare la logica personalmente. Consulta Impostare il webhook a livello di partner per maggiori dettagli.

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 l'app Selettore di progetti nella 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 che hai scaricato 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 in cui hai creato 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 in cui hai creato 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 in cui hai creato 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 del bot Echo, devi specificare l'URL webhook operare) per avviare la ricezione di messaggi.

  1. Apri l'app 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".

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

    Questo endpoint è predefinito nella logica dell'applicazione dell'esempio di esempio di cui è stato 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 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 lo Sviluppatore di comunicazioni aziendali Google Cloud.
  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 lo Sviluppatore di comunicazioni aziendali Google Cloud.
  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 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 Google Maps.

Il messaggio di benvenuto dell'agente ti saluta. A questo punto, puoi interagire l'Echo Bot. Fai eco ai messaggi che ti rispedisci. Inoltre, puoi richiamano 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.