Interroger une base de données

Votre webhook utilise actuellement des données codées en dur dans la fonction cruisePlanCoverage. Au cours de cette étape du tutoriel, vous allez créer une base de données Spanner, la remplir avec les destinations couvertes et mettre à jour votre fonction pour interroger la base de données.

Configuration du projet

Il est important que votre agent Dialogflow et la base de données se trouvent dans le même projet. C'est le moyen le plus simple pour que votre fonction ait un accès sécurisé à votre base de données. Vous devez également activer l'API Spanner.

  1. Avant de créer la base de données, sélectionnez votre projet dans la console Google Cloud .

    Accéder au sélecteur de projet

  2. Activez l'API Spanner pour le projet.

    Activer l'API Spanner

Créer une instance Spanner

Lorsque vous utilisez Spanner pour la première fois, vous devez créer une instance. Celle-ci représente l'allocation des ressources nécessaires aux bases de données Spanner que vous créerez dans cette instance.

  1. Dans la console Google Cloud , accédez à la page Instances Spanner.

    Accéder aux instances Spanner

  2. Cliquez sur Créer une instance.

  3. Pour le nom de l'instance, saisissez Instance du tutoriel.

  4. L'ID de l'instance est automatiquement renseigné en fonction du nom de l'instance.

  5. Dans Choisissez votre configuration, conservez l'option par défaut Régional et sélectionnez le même emplacement régional que celui que vous avez choisi lors de la création de la fonction.

  6. Dans Allouer une capacité de calcul, saisissez 100 unités de traitement. Cela fournit une capacité minimale pour le tutoriel.

  7. Cliquez sur Créer. La console Google Cloud affiche la page de présentation de l'instance que vous avez créée.

Créer une base de données Spanner

Maintenant que vous disposez d'une instance, vous devez créer une base de données. Pour créer une base de données :

  1. Sur la page Présentation de l'instance, cliquez sur Créer une base de données.
  2. Pour le nom de la base de données, saisissez tutorial-database.
  3. Sélectionnez le dialecte de base de données SQL standard Google.
  4. Cliquez sur Créer. La console Google Cloud affiche la page de présentation de la base de données que vous avez créée.

Créer une table pour votre base de données

Maintenant que vous disposez d'une base de données, vous devez y créer une table. Pour créer une table :

  1. Dans la section "Tables" de la page Présentation de la base de données, cliquez sur Créer une table.

  2. Sur la page Écrire des instructions LDD, saisissez :

    CREATE TABLE Destinations (
  Destination STRING(1024),
  Covered BOOL,
) PRIMARY KEY(Destination);

  3. Cliquez sur Envoyer. La console Google Cloud revient à la page Présentation de la base de données et indique que les mises à jour du schéma sont en cours. Attendez que la mise à jour soit terminée.

Insérer des données dans votre table

Maintenant que votre base de données comporte une table, vous devez y ajouter des données. Pour ajouter des données :

  1. Dans la liste des tables de la page Présentation de la base de données, cliquez sur la table "Destinations". La console Google Cloud affiche la page Schéma de la table de destination.
  2. Dans le menu de navigation de gauche, cliquez sur Données pour afficher la page Données de la table de destination.

  3. Cliquez sur Insérer. La console Google Cloud affiche la page Requête de la table Destinations avec un nouvel onglet de requête contenant les instructions INSERT et SELECT. Remplacez ces instructions par les suivantes :

    INSERT INTO Destinations (Destination, Covered)
VALUES('anguilla', TRUE),
      ('canada', TRUE),
      ('china', TRUE),
      ('italy', TRUE),
      ('mexico', TRUE),
      ('spain', FALSE);

  4. Cliquez sur Exécuter.

  5. Dans le menu de navigation de gauche, cliquez à nouveau sur Données pour afficher les données de la table de destination. Vérifiez que la table contient les données souhaitées.

Mettre à jour la fonction Cloud pour interroger la base de données

La fonction cruisePlanCoverage du code du webhook vérifie si des variables d'environnement spécifiques sont définies avec les informations de connexion à la base de données. Si ces variables d'environnement ne sont pas définies, la fonction utilise une liste de destinations codée en dur.

Maintenant que vous avez configuré une base de données, mettez à jour votre fonction Cloud pour définir les variables d'environnement requises :

  1. Ouvrez la page de présentation de Cloud Functions.

    Accéder à la présentation de Cloud Functions

  2. Cliquez sur la fonction "tutorial-telecommunications-webhook" pour accéder à sa page d'informations.

  3. Cliquez sur Modifier.

  4. Ouvrez la section Paramètres d'exécution, de compilation et de connexion.

  5. Sélectionnez l'onglet Environnement d'exécution.

  6. Ajoutez les variables suivantes dans la section "Variables d'environnement d'exécution" :

    • PROJECT_ID : ID du projet.
    • SPANNER_INSTANCE_ID : ID de votre instance Spanner (probablement tutorial-instance)
    • SPANNER_DATABASE_ID : ID de votre base de données Spanner (probablement tutorial-database)

  7. Cliquez sur Suivant.

  8. Cliquez sur Déployer.

  9. Attendez que l'indicateur d'état indique que la fonction a bien été déployée.

Tester votre agent

Votre agent est maintenant prêt à être testé. Cliquez sur le bouton Tester l'agent dans la console Dialogflow pour ouvrir le simulateur. Essayez d'avoir la conversation suivante avec l'agent :

Tour de conversation Vous Agent
1 Bonjour Bonjour ! Je suis l'agent virtuel pour les télécommunications. Je peux vous aider à résoudre les problèmes de facturation et de forfait, à résoudre les problèmes, et à ajouter des forfaits de voyage et de croisière. Comment puis-je vous aider aujourd'hui ?
2 Je souhaite ajouter un forfait croisière Je vais vérifier. Quel est votre numéro de téléphone ?
3 123-123-1234 Combien de jours dure votre croisière ?
4 7 L'option 1 inclut les appels et les SMS. Il coûte [XX] $/jour. Pour en savoir plus, consultez [URL]. L'option 2 inclut les appels, les SMS et les données. Il coûte [XX] $/jour. Pour en savoir plus, consultez [URL]. Quel plan de croisière souhaitez-vous ajouter ?
5 Option 1 OK. J'ai ajouté ce forfait à votre compte. Pendant votre croisière, vous aurez peut-être aussi besoin d'une couverture sur terre. À quel port allez-vous vous arrêter ?
6 Italie Et combien de jours allez-vous y passer ?
7 3 Bonne nouvelle ! L'Italie dispose d'une couverture sans frais sur terre. Tout est prêt. Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?

Si vous examinez le code, l'Italie ne figure pas dans la liste codée en dur des destinations couvertes. Cela signifie que votre webhook s'est bien connecté à la base de données, qui inclut l'Italie.

Dépannage

Le code du webhook inclut des instructions de journalisation. Si vous rencontrez des problèmes, essayez d'afficher les journaux de votre fonction Cloud.

Si votre fonction ne se connecte pas à la base de données et qu'une erreur d'autorisation s'affiche dans les journaux, vous devrez peut-être corriger le rôle du compte de service par défaut utilisé par votre fonction. Ce compte de service se présente sous la forme PROJECT_ID@. Pour résoudre ce problème, vous pouvez procéder de l'une des manières suivantes :

En savoir plus

Pour en savoir plus sur les étapes ci-dessus, consultez les ressources suivantes :

Précédent
Créer un service de webhook
Suivant
Héberger votre agent