Otelo 7

Créé en 2020 et modifié le 19 Oct 2020

Créé en 2020 et modifié le 19 Oct 2020

Chatbot IBM Cloud

L’équipe marketing de votre Hotel propose d’améliorer son service client en proposant de réserver des chambres grâce à un assistant virtuel. L’application permettra d’enregistrer dans une base de données les réservations et de les analyser sur Cognos Analytics.

 

exemples d’assistant virtuel susceptibles de changement :
https://www.facebook.com/PalaisDelOiseaudeJade
https://ibm-poj-4-quiet-tiger.eu-de.mybluemix.net

 

Partie 1 – Watson Assistant

Livrable : otelo/mission7/…

 

• Créer un service Watson Assistant nommé otelo Watson Assistant .
• Accéder à l’outil de lancement.

 

 

 

• Importer le Workspace workspace_palaisdeloiseaudejade.json dans le nouveau skill.

 

 

•  Explorer l’interface. J’ai utilisé les propositions de “Content Catalog” pour élaborer cet assistant virtuel.
•  Essayer l’assistant virtuel. On pourra tester des phrases avec des mots clefs comme blague, bonjour, contact, horaire et réservation.

 

 

•  Modifier la demande du chatbot avec de nouvelles variables pour correspondre aux données nécessaires (dateD,dateF,idPeriode,idchambre). Par simplification, on passera drectement l’idPerdiode et l’idChambre.

 

 

• réaliser un nouvel assistant
• relier l’assistant au skill créé précédemment

 

Partie 2 – Test de l’API Watson Assistant

• Récuperer l’url et les identifiants de l’API Watson Assistant.

 

• Utiliser une application REST comme Postman  pour tester votre assistant virtuel avec les identifiants fournis.

 

Méthode

POST

Dans Authorization ->Basic auth-> apikey et {votre api key}

Dans Body -> raw -JSON-> {« input »:{« text »: »coucou »}}

• Obtenir un id de session avec une url de la forme (ajouter la variable http version)
  https://api.eu-gb.assistant.watson.cloud.ibm.com/instances/{instance id}/v2/assistants/{assistant id}/sessions?version=2019-02-28
• Envoyer un message coucou avec le numero de la session obtenue et une url de la forme
  https://api.eu-gb.assistant.watson.cloud.ibm.com/instances/{instance id}/v2/assistants/{assistant id}/sessions/{idesssion}/message?version=2019-02-28
• L’assistant virtuel répond “Bonjour, en quoi puis-je vous aider ?”.

 

 

 

Partie 3 – MySQL sur IBM Cloud

Livrable : otelo/mission7/…
Partie 3 ou 3 bis au choix

• Créer un service compose for Mysql sur IBM Cloud
•  Se connecter grâce à Adminer à l’instance Mysql avec vos identifiants et l’adresse de l’instance
• Déployer votre base de données Otelo

 

 

 

Partie 3 bis –  MariaDB sur AWS

• Créer un service RDS MariaDB gratuit accessible publiquement en se dirigeant vers la console AWS

 

 

• Modifier le groupe de sécurité pour autoriser l’adresse ip 0.0.0.0/0 à se connecter. (On autorise toutes les adresses, à éviter !)

 

 

• Se connecter grâce à Adminer à l’instance MariaDB avec vos identifiants RDS et l’adresse du point de terminaison.
• Déployer votre base de données Otelo

 

 

 

Partie 4  – Application NodeJS en local

Livrable : otelo/mission7/…
Partie 4, 4bis ou 4 ter au choix

 

• Installer NodeJS

• Télécharger les fichiers du dépot https://gitlab.com/cherryclass/otelo
• Modifier les variables suivantes dans le fichier app.js.

var watsonApiKey = "";
//s'arreter avant v2
var watsonURL ="https://api.eu-gb.assistant.watson.cloud.ibm.com/instances/ba3e7f27-4e83-4906-86eb";
//assistant id
var watsonID='';

var myRDSHost ="database-2.eu-west-3.rds.amazonaws.com";
var myRDSLogin ="admin";
var myRDSPassword ="";

• Dans le répertoire de l’application, executer npm install pour déployer les paquets nécessaires
• Executer npm start pour lancer l’application.

 

• Une fois déployée, accéder à l’application depuis http://localhost:3000 . Vous obtenez l’interface suivante et pouvez tester l’assistant virtuel. Inspecter la console du serveur NodeJS et la console du navigateur.

 

Partie 4 bis – Application NodeJS sur IBM Cloud

Livrable : otelo/mission7/…

 

• Cliquer sur le bouton Deploy to IBM Cloud du dépôt GitHub.

• Créer l’API Key et déployer.

 

• Observer le déploiement dans la chaine de distribution

 

• Echec sur le déploiement de l’application, c’est normal.

 

 

• Modifier les variables suivantes du fichier app.js dans le dépot GIT de la chaîne d’outils.

var watsonApiKey = «  »;
//s’arreter avant v2
var watsonURL = »https://api.eu-gb.assistant.watson.cloud.ibm.com/instances/ba3e7f27-4e83-4906-86eb »;
//assistant id
var watsonID= »;

var myRDSHost = »database-2.eu-west-3.rds.amazonaws.com »;
var myRDSLogin = »admin »;
var myRDSPassword = » »;

 

• L’application se redéploie automatiquement au commit de GIT.

 

• Une fois déployée, accéder à l’application depuis votre tableau de bord.
• Vous obtenez l’interface suivante et pouvez tester l’assistant virtuel.

 

 

 

Optionnel – Déploiement en ligne de commande

 

Si l’étape précédente ne fonctionne pas ou pour découvrir un autre moyen de déployer son application.

• Télécharger le code depuis le dépôt Github et le décompresser.
• Modifier app.js avec les identifiants.
• Installer le client IBM Cloud
• Ouvrir une invite de commande (CMD sous windows) et se connecter à IBM Cloud.

bx login

• En se placant dans le répertoire contenant le code, executer :

bx cf push

 

 

Optionnel –  Debogage – Journaux de l’app

• Installer le client IBM Cloud
• Ouvrir une invite de commande (CMD sous windows) et se connecter à IBM Cloud.

bx login

• Afficher les logs de l’application en remplacant le nom de celle-ci dans la ligne de commande. On observe dans le cadre l’affichage de la réponse de Watson Assistant.
  • vert pour nodejs
  • jaune pour l’assistant

bx cf logs palais-de-l-oiseau-de-jade-nodejs –recent

 

Partie 4 ter – Application NodeJS sur AWS

 

• Réaliser une instance Ligthsail NodeJS sur AWS

 

• Connectez vous à l’instance en ssh

 

• Créer une application NodeJS en suivant ces étapes
  https://docs.bitnami.com/oci/infrastructure/nodejs/administration/create-custom-application-nodejs/

 

 

• Télécharger les fichiers du dépot https://gitlab.com/cherryclass/otelo
• Modifier les variables suivantes dans le fichier app.js.

var watsonApiKey = "";
//s'arreter avant v2
var watsonURL ="https://api.eu-gb.assistant.watson.cloud.ibm.com/instances/ba3e7f27-4e83-4906-86eb";
//assistant id
var watsonID='';

var myRDSHost ="database-2.eu-west-3.rds.amazonaws.com";
var myRDSLogin ="admin";
var myRDSPassword ="";

• Dans le répertoire /opt/bitnami/apps/myapp/htdocs, déployer les fichiers app.js, index.html et package.json (on pourra faire des copier- coller, sudo nano monfichier  ou  sudo rm monfichier)

 

• Dans le repertoire de l’application, executer sudo npm install pour déployer les paquets nécessaires
• Executer npm start pour lancer l’application.

 

• Une fois déployée, accéder à l’application depuis son IP. Vous obtenez l’interface suivante et pouvez tester l’assistant virtuel. Inspecter la console du serveur NodeJS et la console du navigateur.

 

Partie 5 – Enregistrement de la réservation

Livrable : otelo/mission7/…

• Modifier les lignes 214 à 240 pour permettre l’enregistrement de la réservation et de la ligne_reservation
• Intégrer le chatbot au site Otelo, trois solutions
  • via une url externe
  • en utilisant l’intégration d’IBM Cloud (assistant->integrations->webchat-embed)
  • en intégrant la page HTML (risque de probleme CORS)

 

 

 

 

 

 

 

Partie 6 – Cognos Analytics

• S’inscrire à Cognos Analytics https://www.ibm.com/fr-fr/products/cognos-analytics
• Exporter la table reservation depuis Adminer en CSV (virgule)
• Importer le CSV dans Cognos (+ transférer un fichier)

Remarque : Il est possible de relier une base de données hébergées sur IBM Cloud directement à Cognos Analytics. Nous ne pouvons pas créer d’instance Mysql avec le compte d’essai. de même, il n’est pas possible de se connecter à une base de données depuis Cognos avec la version d’essai de celui ci.

 

• Utiliser l’assistant Cognos en anglais pour générer les graphiques suivants :
  • Le nombre de chambres réservées par catégorie
  • Le nombre de réservation par date
  • Le nombre de chambres réservées depuis 1 an par date

Partie 7 – Facebook Messenger

Uniquement pour une application avec un domaine (exemple http:// zorg.zh), dans notre cas IBM Cloud.

• Réaliser une page Facebook dédiée à l’assistant virtuel.
• Se connecter à Facebook Developer.
• Ajouter une application.
• Ajouter le service Messenger.

 

• Générer un token en sélectionnant votre page, accepter les autorisations.

 

 

• Ajouter ce token à myFacebookToken dans app.js en accédant à votre dépôt Git (menu devOps). Le token est dépendant de la page Facebook.
•  Sauvegarder le fichier. L’application se redéploit automatiquement à la sauvegarde. On pourra vérifier le bon fonctionnement dans la pipeline de distribution. Pour AWS, relancer l’application.
• Configurer les webhooks, ajouter l’url de votre application  avec /webhook à la fin et cocher les cases correspondantes.

 

 

 

 

 

Si l’url webhook ne fonctione pas :

• Vérifier que l’application nodeJs fonctionne.
• Vérifier que /webhook est bien renseigné à la fin de l’url.
• Vérifier que le token Facebook est enregistré dans app.js et que l’application est redéployée.

 

 

 

 

•  Ajouter une image pour l’application.

•  Ajouter une URL de politique de confidentialité pour publier votre application . https://frebourg.es/cgu

 

 

 

 

 

• L’assistant virtuel répond au message. On pourra vérifier les logs (section débogage).
  • bleu pour messenger
  • vert pour nodejs
  • jaune pour l’assistant