IBM Cloud Docs
Amélioration de votre conversation

Amélioration de votre conversation

Testez votre dialogue et organisez vos noeuds de dialogue.

Test de votre dialogue

Lorsque vous travaillez sur votre dialogue, vous pouvez le tester à tout moment pour voir comment il réagit à la saisie.

Les requêtes que vous soumettez par l'intermédiaire du volet "Try it out" génèrent des appels à l'API /message, mais ils ne sont pas enregistrés et n'entraînent pas de frais.

  1. Dans la page de dialogue, cliquez sur le bouton Essayer.

  2. Dans le panneau de discussion, tapez un texte et appuyez sur Entrée.

  3. Vérifiez la réponse pour voir si le dialogue a correctement interprété votre entrée et choisi la bonne réponse.

    La fenêtre de discussion indique quelles intentions et quelles entités ont été reconnues dans l'entrée.

    Capture d'écran de la sortie de la boîte de dialogue de test
    Sortie de la boîte de dialogue de test

  4. Pour afficher les intentions principales qui ont été reconnues, placez le pointeur de la souris sur l'icône en forme d'oeil Icône en forme d'oeil affichée en regard de l'intention ayant la cote de confiance la plus élevée.

  5. Si la réponse n'est pas celle que vous attendiez, vous pouvez effectuer les actions suivantes dans le panneau "Try it out" :

    • Si vous souhaitez éditer une entité reconnue dans l'entrée, cliquez sur le nom de l'entité pour l'ouvrir dans la page Entities.
    • Si l'intention incorrecte est reconnue, vous pouvez cliquer sur la flèche en regard du nom de l'intention pour la corriger ou marquer le sujet comme non pertinent. Pour plus d'informations, reportez-vous à la rubrique Amélioration des données d'apprentissage.
  6. Si vous souhaitez savoir quel nœud de l'arbre de dialogue a déclenché une réponse, cliquez sur l'icône de localisation Emplacement à côté de ce nœud.

    Le noeud source est mis en évidence et la route empruntée par l'assistant dans l'arborescence pour y accéder est mise en évidence. La mise en évidence est conservée jusqu'à ce que vous exécutiez une autre action, telle que la saisie d'une nouvelle entrée de test.

  7. Pour vérifier ou définir la valeur d'une variable contextuelle, cliquez sur le lien Manage context.

    Les variables contextuelles que vous avez éventuellement définies dans le dialogue s'affichent.

    En outre, les variables de contexte suivantes sont répertoriées :

    • $timezone: la sous-fenêtre Essayez extrait les informations relatives à l'environnement local de l'utilisateur à partir du navigateur Web et lents utilise pour définir la variable de contexte $timezone. Cette variable contextuelle facilite le traitement des références temporelles dans les échanges du dialogue de test.
    • $metadata: cette variable de contexte contient un nom d'ID utilisateur et une paire de valeurs. Étant donné qu'aucun user_id n'est spécifié par défaut dans la sous-fenêtre Essayez,conversation_id est utilisé comme valeur user_id. Lors de l'exécution, la valeur d'ID est généralement transmise à l'assistant à partir de l'intégration que vous utilisez. Si vous concevez une application personnalisée, vous définissez cette valeur vous-même.

    Vous pouvez ajouter une variable et définir sa valeur pour voir comment le dialogue répond lors de l'échange suivant du dialogue de test. Cette fonctionnalité est utile si, par exemple, le dialogue est configuré pour afficher différentes réponses en fonction d'une valeur de variable contextuelle qui est fournie par l'utilisateur.

    1. Pour ajouter une variable contextuelle, indiquez le nom de la variable et appuyez sur Entrée.
    2. Pour définir une valeur par défaut pour la variable contextuelle, recherchez la variable contextuelle que vous avez ajoutée dans la liste, puis indiquez une valeur pour celle-ci.

    Pour plus d'informations, voir Variables contextuelles.

  8. Continuez d'interagir avec le dialogue pour voir de quelle façon la conversation circule à travers lui.

    • Pour rechercher et soumettre à nouveau un énoncé de test, vous pouvez appuyer sur la touche de déplacement vers le haut pour faire défiler les entrées récentes.
    • Pour retirer les précédents énoncés de test sur le panneau de discussion et recommencer, cliquez sur le lien Clear. Cette action permet non seulement de retirer les énoncés et les réponses de test, mais également les valeurs des variables contextuelles qui ont été définies suite à vos interactions avec le dialogue.

Etape suivante

Modifiez la boîte de dialogue pour résoudre les problèmes que vous voyez lors du test:

  • Si vous constatez que les intentions ou les entités reconnues sont incorrectes, vous devrez peut-être modifier vos définitions d'intention ou d'entité.
  • Si les bonnes intentions et entités sont reconnues, mais que les mauvais nœuds sont déclenchés dans votre dialogue, assurez-vous que vos conditions sont écrites correctement.

Copie d'un noeud de dialogue

Vous pouvez dupliquer un noeud afin d'en créer une copie exacte en tant que noeud homologue juste après lui l'arborescence du dialogue. Le noeud copié lui-même a le même nom que le noeud d'origine, mais - copyn y est ajouté, où n est un nombre commençant par 1. Si vous dupliquez le même noeud plusieurs fois, le n dans le nom incrémente d'un pour chaque copie pour vous aider à distinguer les copies les unes des autres. Si le noeud n'a pas de nom, il prend le nom copyn.

Lorsque vous dupliquez un noeud qui a des noeuds enfant, ces derniers sont également dupliqués. Les noeuds enfant copiés portent le même nom que les noeuds enfant d'origine. Seule la référence copy dans le nom du noeud parent permet de distinguer un noeud enfant copié d'un noeud enfant d'origine.

  1. Sur le nœud que vous souhaitez copier, cliquez sur l'icône Node options Node options, puis sélectionnez Duplicata.

  2. Pensez à renommer les noeuds copiés ou à éditer leurs conditions pour les rendre distinctes.

Déplacement d'un noeud de dialogue

Chaque noeud que vous créez peut être déplacé ailleurs dans l'arborescence de dialogue.

Vous souhaiterez peut-être déplacer un noeud précédemment créé vers une autre zone du flux dans le modifier la conversation. Vous pouvez déplacer des noeuds pour qu'ils deviennent des éléments apparentés ou des homologues dans une autre branche.

  1. Sur le nœud que vous souhaitez déplacer, cliquez sur l'icône Node options Node options, puis sélectionnez Déplacer.

  2. Sélectionnez un noeud cible dans l'arborescence près de l'emplacement où vous souhaitez déplacer ce noeud. Indiquez si vous souhaitez placer ce noeud avant ou après le noeud cible ou en faire un enfant du noeud cible.

Organisation du dialogue à l'aide de dossiers

Vous pouvez regrouper des noeuds de dialogue en les ajoutant à un dossier. Les raisons pour lesquelles les noeuds sont regroupés sont les suivantes:

  • Pour conserver ensemble des noeuds qui traitent d'un sujet similaire afin de pouvoir les trouver plus facilement. Par exemple, vous souhaiterez peut-être regrouper dans un dossier Compte utilisateur les noeuds qui traitent de questions concernant les comptes utilisateur et regrouper dans un dossier Paiement les noeuds qui gèrent les requêtes liées aux paiements.
  • Pour regrouper un ensemble de nœuds que la boîte de dialogue ne doit traiter que si une certaine condition est remplie. Utilisez une condition, telle que $isPlatinumMember, pour regrouper les nœuds qui offrent des services supplémentaires qui ne sont traités que si l'utilisateur actuel a le droit de recevoir ces services supplémentaires.
  • Pour rendre les noeuds invisibles pour le contexte d'exécution pendant que vous travaillez dessus. Vous pouvez ajouter les noeuds à un dossier avec une condition false afin d'empêcher leur traitement.

Ces caractéristiques du dossier ont un impact sur la façon dont les noeuds d'un dossier sont traités :

  • Condition : si aucune condition n'est spécifiée, l'assistant traite directement les noeuds du dossier. Si une condition est spécifiée, l'assistant évalue d'abord la condition de dossier afin de déterminer s'il convient de traiter les noeuds contenus dans le dossier.
  • Personnalisations : tous les paramètres de configuration que vous appliquez au dossier sont hérités par les noeuds du dossier. Si vous modifiez les paramètres de digression du dossier, par exemple, les modifications sont héritées par tous les noeuds présents dans le dossier.
  • Hiérarchie d'arborescence : les noeuds présents dans un dossier sont traités en tant que noeuds racine ou enfant selon que le dossier est ajouté à l'arborescence de dialogue au niveau racine ou enfant. Tous les noeuds de niveau racine que vous ajoutez au dossier de niveau racine continuent de fonctionner en tant que noeuds racine ; ils ne deviennent pas des noeuds enfant du dossier, par exemple. Toutefois, si vous déplacez un noeud de niveau racine dans un dossier qui est un enfant d'un autre noeud, le noeud racine devient alors un enfant de cet autre noeud.

Les dossiers n'ont aucun impact sur l'ordre d'évaluation des noeuds. Les noeuds continuent d'être traités du premier au dernier. Lorsque votre assistant suit l'arbre, si le dossier n'a pas de condition ou si sa condition est vraie, il traite immédiatement le premier nœud du dossier et continue à descendre l'arbre dans l'ordre. Si un dossier n'a pas de condition de dossier, chaque nœud du dossier est traité comme n'importe quel autre nœud individuel de l'arbre.

Ajout d'un dossier

Pour ajouter un dossier à une arborescence de dialogue, procédez comme suit :

  1. Dans l'arborescence de la boîte de dialogue, cliquez sur Ajouter un dossier.

    Le dossier est ajouté à la fin de l'arborescence de dialogue, juste avant le noeud Anything else. Sauf si un noeud existant dans l'arborescence est sélectionné, auquel cas, il est ajouté après le noeud sélectionné.

    Si vous souhaitez ajouter le dossier ailleurs dans l'arborescence, à partir du nœud précédant l'endroit où vous souhaitez l'ajouter, cliquez sur l'icône Node options Node options, puis sélectionnez Ajouter un dossier.

    Vous pouvez ajouter un dossier après un noeud enfant dans une branche de dialogue existante. Pour ce faire, cliquez sur l'icône Node options Node options sur le nœud enfant, puis sélectionnez Ajouter un dossier.

    Le dossier s'ouvre dans la vue d'édition.

  2. Facultatif : donnez un nom au dossier.

  3. Facultatif : définissez une condition pour le dossier.

    Si vous ne spécifiez pas une condition, la valeur true est utilisée, ce qui signifie que les noeuds présents dans le dossier seront toujours traités.

  4. Ajoutez des noeuds de dialogue au dossier.

    • Pour ajouter des noeuds de dialogue au dossier, vous devez les déplacer un par un vers le dossier.

      Sur le nœud que vous souhaitez déplacer, cliquez sur l'icône Node options Node options, sélectionnez Déplacer, puis cliquez sur le dossier. Sélectionnez To folder comme cible du déplacement.

      A mesure que vous déplacez des noeuds, ils sont ajoutés au début de l'arborescence dans le dossier. Par conséquent, si vous souhaitez conserver l'ordre d'un ensemble de noeuds de dialogue racine consécutifs, par exemple, déplacez-les en commençant par le dernier noeud.

    • Pour ajouter un nœud de dialogue au dossier, cliquez sur l'icône Node options Node options dans le dossier, puis sélectionnez Ajouter un nœud à un dossier.

      Le noeud de dialogue est ajouté à la fin de l'arborescence de dialogue dans le dossier.

Suppression d'un dossier

Vous pouvez supprimer un dossier seulement ou supprimer le dossier et tous les noeuds de dialogue qu'il contient.

Pour supprimer un dossier, procédez comme suit :

  1. Dans la vue d'arborescence de l'onglet Dialog, recherchez le dossier que vous souhaitez supprimer.

  2. Cliquez sur l'icône Node options Node options dans le dossier, puis sélectionnez Supprimer.

  3. Effectuez l'une des tâches suivantes :

    • Pour supprimer le dossier seulement et conserver les noeuds de dialogue qu'il contient, désélectionnez la case Delete the nodes inside the folder, puis cliquez sur Yes, delete it.
    • Pour supprimer le dossier et tous les noeuds de dialogue qu'il contient, cliquez sur Yes, delete it.

Si vous avez supprimé le dossier seulement, les noeuds qu'il contenait sont affichés dans l'arborescence de dialogue à l'endroit où le dossier se trouvait.

Nombre limite de noeuds de dialogue

Le nombre de noeuds de dialogue que vous pouvez créez par compétence dépend du type de votre plan.

Détails du plan
Plan Nombre de noeuds de dialogue par compétence
Entreprise 100 000
Premium (existant) 100 000
Plus 100 000
Essai 25 000
Lite 25 000

Les nœuds des boîtes de dialogue welcome et anything_else qui sont pré-remplis dans l'arbre comptent dans le total.

Limite de profondeur de l'arborescence : la boîte de dialogue prend en charge 2 000 descendants de nœuds de boîte de dialogue ; la boîte de dialogue fonctionne mieux avec 20 ou moins.

Recherche d'un noeud de dialogue au moyen de son ID

Vous pouvez rechercher un noeud de dialogue par son ID de noeud. Entrez l'ID de noeud complet dans la zone de recherche. Vous souhaiterez peut-être rechercher le noeud de dialogue qui est associé à un ID de noeud connu si vous vous trouvez dans l'une des situations suivantes :

  • Vous passez en revue des journaux, et un journal fait référence à une section du dialogue au moyen de son ID de noeud.
  • Vous souhaitez mapper les ID de noeud répertoriés dans la propriété nodes_visited de la sortie du message d'API aux noeuds qui sont affichés dans l'arborescence de votre dialogue.
  • Un message d'erreur d'exécution de dialogue vous informe d'une erreur de syntaxe et identifie le noeud à corriger par son ID.

Une autre façon de découvrir un noeud en fonction de son ID de noeud consiste à effectuer les étapes suivantes :

  1. Dans la page Dialog, sélectionnez un noeud dans l'arborescence de votre dialogue.

  2. Fermez la vue d'édition si elle est ouverte pour le noeud en cours.

  3. Dans le champ d'emplacement de votre navigateur web, une URL devrait s'afficher avec une syntaxe similaire à l'exemple suivant :

    https://{location}.assistant.watson.cloud.ibm.com/{location}/{instance-id}/skills/{skill-id}/build/dialog#node={node-id}

  4. Modifiez l' URL en remplaçant la valeur actuelle de {node-id} par l'ID du nœud que vous souhaitez trouver, puis soumettez la nouvelle URL.

  5. Si nécessaire, remettez en évidence l'URL éditée, puis soumettez-la à nouveau.

La page effectue une actualisation et le noeud de dialogue portant l'ID de noeud que vous avez spécifié est mis en évidence. Si l'ID de noeud concerne un attribut, une condition d'attribut Found ou Not found, un gestionnaire d'attributs ou une réponse conditionnelle, le noeud dans lequel l'attribut ou la réponse conditionnelle est défini est mis en évidence et le modal correspondant s'affiche.

Si le noeud est toujours introuvable, vous pouvez exporter la compétence de dialogue et utiliser un éditeur JSON pour effectuer une recherche dans le fichier JSON de la compétence.

Combien de noeuds mon dialogue contient-il ?

Pour connaître le nombre de noeuds de dialogue dans une compétence de dialogue, effectuez l'une des opérations suivantes :

  • Si elle n'est pas déjà associée à un assistant, ajoutez la compétence de dialogue à un assistant, puis affichez la vignette de compétence à partir de la page principale de celui-ci. La section Données formées répertorie le nombre de noeuds de dialogue.

  • Envoyez une requête GET au point de terminaison de l'API /dialog_nodes, et incluez le paramètre include_count=true. Exemple :

    curl -u "apikey:{apikey}" "{url}/v1/workspaces/{workspace_id}/dialog_nodes?version=2018-09-20&include_count=true"
    

    où {url} est l'URL de votre instance. Pour plus d'informations, voir Noeud final de service.

    Dans la réponse, l'attribut total de l'objet pagination contient le nombre de noeuds du dialogue.

Si le total semble plus important que prévu, c'est peut-être parce que le dialogue que vous créez à partir de l'application est converti en un objet JSON. Certains champs qui semblent faire partie d'un seul nœud sont structurés comme des nœuds de dialogue distincts dans l'objet JSON sous-jacent.

  • Chaque noeud et dossier est représenté comme son propre noeud.
  • Chaque réponse conditionnelle associée à un noeud unique de dialogue est représentée sous la forme d'un noeud individuel.
  • Pour un noeud avec attributs, chaque attribut, réponse d'attribut trouvé, réponse d'attribut non trouvé, gestionnaire d'attribut et, si elle est définie, la réponse "Prompt for everything" est un noeud individuel. En effet, un noeud avec trois attributs peut être équivalent à onze noeuds de dialogue.