Conditions préalables
Voici les technologies utilisées dans ce projet :
- Compte Google Cloud
- API Dialogflow activée
- Interface de ligne de commande Dialogflow CX
Que sont les intents Dialogflow CX ?
Chaque intent comporte des phrases d’entraînement. Par exemple, le welcome_intent
intent peut avoir ces 3 phrases d’entraînement :
- « Salut »
- « Bonjour »
- « Quoi de neuf? »
Comme vous pouvez le voir dans l’exemple ci-dessus, notre intention avec le welcome_intent
l’intention est de démarrer une conversation lorsqu’un utilisateur prononce l’une de ces phrases d’entraînement. Une intention peut avoir plusieurs entités. Les entités seront expliquées dans un prochain article.
Pour montrer un autre exemple, si nous regardons l’image ci-dessus, nous verrons le get_info
intention. Cet intent comporte également plusieurs phrases d’entraînement :
- « Dites-moi des infos sur Pikachu »
- « Donnez-moi des informations sur Pikachu »
- « Info Pikachu »
- « Pikachu »
Nous pouvons donc demander des informations sur un certain Pokémon de plusieurs manières. Dans cet exemple, pikachu
est une entité.
Il est recommandé de tester vos phrases d’entraînement avec vos utilisateurs finaux. Cela vous permettra de détecter les phrases d’entraînement manquantes dans votre NLU.
Console de flux de dialogue
La console Dialogflow est une interface Web dans laquelle vous pouvez concevoir vos conversations en créant des agents, et au sein d’un agent, créer des flux, des intents, des types d’entités, etc. Sur la console Dialogflow, vous pouvez créer et interagir facilement avec votre intent. Pour ce faire, il vous suffit d’accéder à la console Dialogflow CX. Voici à quoi cela ressemble :
Vous trouverez vos intentions dans le Gérer onglet et le clic dans l’onglet intentions section:
Avec la console Dialogflow CX, vous pouvez effectuer les opérations suivantes :
- Créer une intention : lorsque vous créez une intention, vous pouvez ajouter des phrases d’entraînement et ajouter une description ou des étiquettes à cette intention. Vous pouvez également ajouter des types d’entités à une intention.
- Supprimer une intention.
- Entraînez et validez votre NLU.
Chaque fois que vous créez, modifiez ou supprimez un intent, il est important de réentraîner vos flux Dialogflow CX. Cela entraînera à nouveau votre NLU. En faisant cela, votre bot vous « comprendra », y compris vos dernières modifications.
Interface de ligne de commande Dialogflow CX
La CLI Dialogflow CX ou cxcli
est un outil d’interface de ligne de commande que vous pouvez utiliser pour interagir avec vos projets Dialogflow CX dans un terminal. C’est un projet open-source que j’ai créé. Avec le cxcli
vous pouvez interagir facilement avec vos intents Dialogflow CX.
Toutes les commandes disponibles dans le cxcli
pour interagir avec votre intention sont situés en bas de la cxcli intent
commande.
Créer
Vous pouvez créer une intention à l’aide de cet outil. Cette commande a cet usage :
cxcli intent create [intent-name] [parameters]
Vous pouvez trouver l’utilisation complète ici. Il est important d’expliquer le --training-phrases
paramètre. Pourquoi? Parce que c’est le paramètre le plus important. Il s’agit d’une liste d’expressions d’entraînement pour cette intention, séparées par des virgules. Pour les entités utilisées dans cet intent, ajoutez @entity-type
au mot dans la phrase d’entraînement. C’est le format :
word@entity-type
Ici vous avez un exemple : hello, hi how are you today@sys.date, morning!
Ceci est un exemple simple de la cxcli intent create
commande:
cxcli intent create test_intent --training-phrases "hello, hi how are you today@sys.date, morning" --agent-name test-agent --project-id test-cx-346408 --location-id us-central1
La commande ci-dessus vous donnera une sortie comme celle-ci :
$ cxcli intent create test_intent --training-phrases "hello, hi how are you today@sys.date, morning" --agent-name test-agent --project-id test-cx-346408 --location-id us-central1
INFO Intent created with id: projects/test-cx-346408/locations/us-central1/agents/40278ea0-c0fc-4d9a-a4d4-caa68d86295f/intents/a7870357-e942-43dd-99d2-4de8c81a3c09
Tu peux voir le test_intent
sur la console Dialogflow CX :
Supprimer
De plus, une intention peut être supprimée. L’utilisation de cette commande est assez similaire à celle utilisée pour créer une intention :
cxcli intent delete [intent-name] [parameters]
Vous pouvez trouver l’utilisation complète ici. Ceci est un exemple simple de la cxcli intent delete
commande:
cxcli intent delete test_intent --agent-name test-agent --project-id test-cx-346408 --location-id us-central1
La commande ci-dessus vous donnera une sortie comme celle-ci :
$ cxcli intent delete test_intent --agent-name test-agent --project-id test-cx-346408 --location-id us-central1
INFO Intent deleted
Ressources
Si vous voulez vérifier l’utilisation complète du cxcli intent
commande, veuillez vous référer à cette page.
Si vous souhaitez en savoir plus sur les intents Dialogflow CX, consultez la documentation officielle.
Conclusion
Il s’agissait d’un didacticiel de base pour découvrir ce qu’est une intention Dialogflow CX. Comme vous l’avez vu dans cet exemple, la création d’intents et l’évolution de votre NLU dans Dialogflow CX avec la console ou le cxcli
C’est très facile!
J’espère que ce tutoriel vous sera utile.
C’est tout ! Bon codage !