Héberger votre agent

La dernière étape de ce tutoriel consiste à héberger votre agent Dialogflow. App Engine est utilisé pour l'hébergement, car il est simple à configurer et évolue bien. L'intégration de Dialogflow Messenger est utilisée pour l'interface utilisateur d'un agent.

Configuration du projet

Idéalement, votre agent Dialogflow et l'instance App Engine font partie du même projet. En outre, vous devez activer l'API Cloud Build.

  1. Avant de créer l'instance, sélectionnez votre projet dans la console Google Cloud.

    Accéder au sélecteur de projet

  2. Activez l'API Cloud Build pour le projet.

    Activer l'API Cloud Build

Configuration de l'environnement

Vous devez installer et configurer certains éléments afin de développer une application Go pour App Engine. Suivez toutes les étapes que vous n'avez pas encore effectuées dans la section Configurer votre environnement de développement.

Créer le code du service Web

L'exemple de code de ce tutoriel est écrit en Go, mais vous pouvez utiliser n'importe quel langage compatible avec App Engine. Créez la structure de fichiers suivante n'importe où sur votre ordinateur local:

  • go-app/: répertoire de votre service Go.
    • templates/: répertoire de vos modèles HTML Go.
      • index.html: modèle HTML Go.
    • app.yaml : paramètres de configuration du service
    • main.go : code de votre application

Les trois sections suivantes fournissent le contenu de ces trois fichiers.

Contenu du fichier index.html

Ce fichier de modèle Go HTML contient le code HTML de la page d'accueil. Dans ce fichier, insérez le contenu suivant:

<!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>

Contenu du fichier app.yaml

Il s'agit d'un fichier de configuration qui spécifie les paramètres d'environnement d'exécution de votre service. Vous pouvez consulter le document Environnement d'exécution Go 1.12+ pour obtenir la liste des versions compatibles de Go. Dans ce fichier, insérez le contenu suivant:

runtime: go116  # or another supported version

Contenu du fichier main.go

Ce fichier contient le code de votre application. Dans ce fichier, insérez le contenu suivant:

// 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)
	}
}

Déployer votre service Web

Votre code est maintenant prêt à être déployé. Ces étapes utilisent l'outil gcloud pour le déploiement:

  1. Assurez-vous que gcloud est configuré avec le même projet que votre agent Dialogflow. Pour vérifier le projet:

    gcloud config get-value project

    Pour changer de projet:

    gcloud config set project YOUR_PROJECT

  2. Dans le répertoire go-app où se trouve votre fichier app.yaml, déployez votre service Web sur App Engine à l'aide de la commande suivante:

    gcloud app deploy

    La commande vous invite à indiquer une région. Veillez à sélectionner la même région que votre agent Dialogflow. La commande génère la valeur target url, qui correspond à l'URL de votre service Web.

  3. Pour lancer votre navigateur et afficher votre service Web, vous pouvez ouvrir l'URL cible de l'étape précédente ou exécuter la commande suivante:

    gcloud app browse

Configurer Dialogflow Messenger

Pour configurer et activer Dialogflow Messenger :

  1. Accédez à la console Dialogflow ES.
  2. Cliquez sur Integrations (Intégrations) dans le menu de la barre latérale gauche.
  3. Cliquez sur Dialogflow Messenger.
  4. Une boîte de dialogue de configuration s'ouvre.
  5. Sélectionnez un environnement.
  6. Cliquez sur Activer.
  7. Copiez le code d'intégration à coller dans votre site Web.
  8. Cliquez sur Fermer.

Intégrer l'agent dans votre service Web

Collez le code d'intégration que vous avez copié ci-dessus dans votre fichier index.html. Les éléments HTML <script> et <df-messenger> doivent se trouver dans l'élément <body> de votre page.

Déployez à nouveau votre application de service Web avec gcloud. Une fois déployé, vous pouvez interagir avec votre agent via la page Web en cliquant sur l'icône de chat en bas à droite.

Capture d'écran de l'agent Dialogflow intégré à une page Web

Vous disposez maintenant d'un agent Dialogflow entièrement déployé. Essayez d'en discuter avec l'agent.

Nettoyage

En suivant les étapes de ce tutoriel, vous avez créé des ressources facturables. Pour éviter que des frais supplémentaires ne soient facturés sur votre compte Google Cloud, procédez comme suit:

  1. Supprimez votre instance de base de données.

  2. Supprimez la fonction:

    gcloud functions delete tutorial-telecommunications-webhook

  3. Désactivez votre application.

  4. Supprimer votre agent

Informations complémentaires

Pour en savoir plus sur les étapes ci-dessus, consultez les articles suivants:

Précédent
Interroger une base de données