Ospita il tuo agente

Il passaggio finale di questo tutorial consiste nell'ospitare l'agente Dialogflow. App Engine viene utilizzato per l'hosting, perché è semplice da configurare e si adatta bene. La Messaggero Dialogflow per l'interfaccia utente di un agente.

Configurazione progetto

Idealmente, l'agente Dialogflow e l'istanza App Engine sono entrambi nello stesso progetto. Inoltre, devi abilitare l'API Cloud Build.

  1. Prima di creare l'istanza, seleziona il progetto dalla console Google Cloud.

    Vai al selettore progetti

  2. Abilita l'API Cloud Build per il progetto.

    Abilita l'API Cloud Build

Configurazione dell'ambiente

Per sviluppare un'applicazione Go per App Engine, devi installare e configurare alcune cose. Segui i passaggi che non hai ancora completato in Configurazione dell'ambiente di sviluppo.

Crea il codice del servizio web

Il codice di esempio per questo tutorial è scritto in Go, ma puoi usare qualsiasi linguaggio supportato da App Engine. Crea la seguente struttura di file ovunque sulla tua macchina locale:

  • go-app/: la directory del tuo servizio Go.
    • templates/: la directory per i modelli HTML di Go.
      • index.html: vai al modello HTML.
    • app.yaml: le impostazioni di configurazione del tuo servizio.
    • main.go: il codice della tua applicazione.

Le tre sezioni successive forniscono i contenuti per i tre file.

Contenuti del file index.html

Questo file modello Go HTML contiene il codice HTML per la home page. Compila questo file con i seguenti contenuti:

<!DOCTYPE html>
<html lang="en-US">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width">
    <title>Tutorial agent</title>
  </head>
  <body>
    <p>Open the chat window in the bottom right corner.</p>
  </body>
</html>

Contenuti del file app.yaml

Si tratta di un file di configurazione specifica le impostazioni dell'ambiente di runtime del tuo servizio. Puoi fare riferimento alle Documento sull'ambiente di runtime Go 1.12 e versioni successive per visualizzare l'elenco delle versioni di Go supportate. Compila questo file con i seguenti contenuti:

runtime: go116  # or another supported version

Contenuti del file main.go

Questo file contiene il codice dell'applicazione. Compila questo file con i seguenti contenuti:

// Package main is the main package
package main

import (
	"log"
	"net/http"
	"os"
	"text/template"
)

var templates *template.Template

func init() {
	templates = template.Must(template.New("").ParseGlob("templates/*"))
}

// indexHandler handles the homepage.
func indexHandler(w http.ResponseWriter, r *http.Request) {
	if r.URL.Path != "/" {
		http.NotFound(w, r)
		return
	}
	if err := templates.ExecuteTemplate(w, "index.html", nil); err != nil {
		log.Fatal(err)
	}
}

func main() {
	// Register the handlers
	http.HandleFunc("/", indexHandler)

	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
		log.Printf("Defaulting to port %s", port)
	}

	log.Printf("Listening on port %s", port)
	if err := http.ListenAndServe(":"+port, nil); err != nil {
		log.Fatal(err)
	}
}

Deployment del servizio web

Il codice è ora pronto per il deployment. Questi passaggi utilizzano strumento gcloud per il deployment:

  1. Assicurati che gcloud sia configurato con lo stesso progetto dell'agente Dialogflow. Per controllare il progetto:

    gcloud config get-value project

    Per modificare il progetto:

    gcloud config set project YOUR_PROJECT

  2. Nella directory go-app in cui si trova il file app.yaml, esegui il deployment da App Engine ad App Engine utilizzando il comando seguente:

    gcloud app deploy

    Il comando ti chiederà di specificare una regione. Assicurati di selezionare la stessa regione dell'agente Dialogflow. Il comando restituirà il valore target url, ovvero l'URL del tuo servizio web.

  3. Per aprire il browser e visualizzare il servizio web, puoi aprire l'URL di destinazione dal passaggio precedente oppure esegui questo comando:

    gcloud app browse

Configurare Dialogflow Messenger

Per configurare e attivare Dialogflow Messenger:

  1. Vai alla console Dialogflow ES.
  2. Fai clic su Integrations (Integrazioni) nel menu della barra laterale a sinistra.
  3. Fai clic su Dialogflow Messenger.
  4. Si apre una finestra di dialogo di configurazione.
  5. Scegli un ambiente.
  6. Fai clic su Attiva.
  7. Copia il codice di incorporamento da incollare nel tuo sito web.
  8. Fai clic su Chiudi.

Incorpora l'agente nel tuo servizio web

Incolla nel file index.html il codice di incorporamento che hai copiato in precedenza. Gli elementi HTML <script> e <df-messenger> deve trovarsi nell'elemento <body> della pagina.

Esegui nuovamente il deployment dell'app del servizio web con gcloud. Una volta eseguito il deployment, puoi interagire con l'agente tramite la pagina web facendo clic sull'icona della chat nell'angolo in basso a destra.

Screenshot dell&#39;agente Dialogflow incorporato in una pagina web

Ora hai un agente Dialogflow completamente di cui è stato eseguito il deployment. Prova a parlare con l'agente.

Esegui la pulizia

Mentre segui i passaggi di questo tutorial, hai creato risorse fatturabili. Per evitare che al tuo account Google Cloud vengano addebitati costi aggiuntivi:

  1. Elimina l'istanza di database.

  2. Elimina la funzione:

    gcloud functions delete tutorial-telecommunications-webhook

  3. Disattiva l'app.

  4. Eliminare l'agente

Ulteriori informazioni

Per ulteriori informazioni sui passaggi precedenti, vedi:

Indietro
esegui una query su un database