Pour créer une brique, vous pouvez cloner une version d'une autre brique, en importer une, ou en créer une de toutes pièces, comme décrit ici.

1. Cliquez sur pour ouvrir le menu latéral, sélectionnez Développement > Briques, puis cliquez sur Nouvelle brique.

2. Dans la boîte de dialogue Créer une brique, remplissez les champs requis.

3. Dans le champ Version de plate-forme, vous pouvez sélectionner une autre version de plate-forme.

   Ce paramètre a un impact sur le comportement de vos briques, comme la façon dont le moteur de compréhension du langage naturel (NLU) résout les intentions. Par défaut, il est défini sur la version de plate-forme la plus récente.

   Si vous avez spécifiquement besoin que le clone se comporte comme des briques basées sur une autre version de plate-forme, sélectionnez la version utilisée par ces briques.

   Reportez-vous à Version de plate-forme.

4. Si vous avez sélectionné la version 20.12 de la plate-forme ou une version supérieure, dans le champ Langue principale, sélectionnez la langue par défaut de votre brique.

   Si vous prévoyez de concevoir la brique pour plusieurs langues, réfléchissez très attentivement à ce que vous choisissez. Plus particulièrement, si vous voulez prendre en charge d'autres langues que celles prises en charge de façon native, faites défiler la page vers le bas jusqu'à la section Service de traduction de la liste déroulante, puis sélectionnez Anglais.

   Afin d'obtenir plus d'informations sur la conception de briques pour les langues cible souhaitées, reportez-vous à Langues et briques.

   Remarque
   
   Sur les versions de plate-forme 20.09 et inférieures, vous n'indiquez pas de langue principale. A la place, une langue prédominante est automatiquement détectée pour la brique lorsque vous la configurez avec un service de traduction.

5. Cliquez sur Créer.

Une fois la brique créée, elle apparaît dans le catalogue de briques en mode brouillon.

Si vous voulez créer une brique semblable à une brique existante, ou si vous voulez réutiliser les artefacts d'une brique existante, vous pouvez créer une brique par clonage.

Pour cloner une version d'une brique, procédez comme suit :

1. Dans le catalogue de briques, localisez la version à cloner.

2. Cliquez sur l'icône Options et sélectionnez Cloner.

3. Remplissez la boîte de dialogue en prêtant une attention particulière aux champs suivants :
   • Version de plate-forme : la version de la plate-forme a une incidence sur le comportement des briques, comme la façon dont le moteur de compréhension du langage naturel (NLU) résout les intentions et les langues prises en charge de façon native.

     Si vous avez spécifiquement besoin que le clone se comporte comme la brique de base, sélectionnez la version de plate-forme utilisée par cette brique.

     Reportez-vous à Version de plate-forme.

   • Langue principale (apparaît uniquement si la version de plate-forme sélectionnée est 20.12 ou une version supérieure) : détermine la langue par défaut de la brique, et si la brique utilise la prise en charge native de cette langue ou s'appuie sur un service de traduction.

     Si vous prévoyez de concevoir la brique pour plusieurs langues, réfléchissez très attentivement à ce que vous choisissez ici. Plus particulièrement, si vous voulez prendre en charge d'autres langues que celles prises en charge de façon native, faites défiler la page vers le bas jusqu'à la section Service de traduction de la liste déroulante, puis sélectionnez Anglais.

     Afin d'obtenir plus d'informations sur la conception de briques pour les langues cible souhaitées, reportez-vous à Langues et briques.

     Remarque
     
     Sur les versions de plate-forme 20.09 et inférieures, vous n'indiquez pas de langue principale. En revanche, une langue prédominante est automatiquement détectée si vous avez configuré la brique avec un service de traduction.

Vous pouvez créer une brique en important une version d'une brique exportée à partir d'une autre instance. La brique importée sera en mode brouillon, même si elle était publiée dans l'instance source.

Pour importer une version d'une brique, procédez comme suit :

1. Dans le catalogue de briques, cliquez sur Importer une brique.

2. Téléchargez le fichier ZIP contenant la brique exportée.

3. Par défaut, les analyses sont désactivées pour les briques importées. Pour activer la génération de rapports d'analyse sur la brique importée, cliquez d'abord sur , puis sélectionnez Activer les analyses.

Vous pouvez créer une autre version d'une brique, par exemple pour ajouter de nouvelles fonctionnalités.

Pour créer une autre version, procédez comme suit :

1. Dans le catalogue de briques, localisez la version à partir de laquelle créer une autre version.

2. Cliquez sur l'icône Options et sélectionnez Nouvelle version.

3. Remplissez la boîte de dialogue en prêtant une attention particulière aux champs suivants :
   • Version de plate-forme : la version de la plate-forme a une incidence sur le comportement des briques, comme la façon dont le moteur de compréhension du langage naturel (NLU) résout les intentions et les langues prises en charge de façon native.

     Si vous avez spécifiquement besoin que cette version de la brique se comporte comme la version précédente, sélectionnez la version de plate-forme utilisée par la brique de base.

     Reportez-vous à Version de plate-forme.

   • Langue principale (apparaît uniquement si la version de plate-forme sélectionnée est 20.12 ou une version supérieure) : détermine la langue par défaut de la brique, et si la brique utilise la prise en charge native de cette langue ou s'appuie sur un service de traduction.

     Si vous prévoyez de concevoir la brique pour plusieurs langues, réfléchissez très attentivement à ce que vous choisissez ici. Plus particulièrement, si vous voulez prendre en charge d'autres langues que celles prises en charge de façon native, faites défiler la page vers le bas jusqu'à la section Service de traduction de la liste déroulante, puis sélectionnez Anglais.

     Afin d'obtenir plus d'informations sur la conception de briques pour les langues cible souhaitées, reportez-vous à Langues et briques.

     Remarque
     
     Sur les versions de plate-forme 20.09 et inférieures, vous n'indiquez pas de langue principale. En revanche, une langue prédominante est automatiquement détectée si vous avez configuré la brique avec un service de traduction.

Lorsque vous créez une brique, vous disposez de deux options pour concevoir le flux de dialogue :

• Visuel. Vous utilisez Visual Flow Designer pour concevoir des flux de dialogue sur un canevas avec des mosaïques pour chaque état et avec les connexions entre les états également représentées visuellement. Les variables, les paramètres et les propriétés des composants sont définis dans des éditeurs et des boîtes de dialogue spécialisés. En outre, l'éditeur visuel vous permet de créer des flux modulaires. Il s'agit du mode par défaut pour les nouvelles compétences.
• YAML. Vous définissez le cadre de l'échange de compétences utilisateur dans un langage de balisage simple qui vous permet de décrire un dialogue à la fois en termes de ce que la brique doit dire et de ce qu'elle fait. L'ensemble de la définition du flux de dialogue est défini dans un fichier unique.

Pour préparer une version d'une brique à utiliser dans un assistant numérique, configurez les paramètres suivants :

• Nom d'appel : nom à l'aide duquel l'utilisateur peut appeler de façon explicite la brique dans l'assistant numérique.

  Reportez-vous à Instructions relatives aux noms d'appel.

• Exemples de variation : ces variations aident le moteur d'intentions à déterminer quand l'utilisateur souhaite appeler cette brique. Dans les exemples de variation, il est préférable d'inclure également le nom d'appel pour améliorer la mise en correspondance des variations utilisateur avec la brique.

  Les premières variations apparaissent également sur la carte de la brique que l'assistant numérique fournit par défaut aux états de bienvenue et d'aide.

Pour les briques développées en mode YAML, vous pouvez éventuellement spécifier les paramètres Etat de début, Etat de bienvenue et Etat d'aide. Reportez-vous à la section Etat de démarrage, de bienvenue et d'aide. (Pour les compétences développées en mode Visuel, ces paramètres ne sont pas disponibles. Au lieu de cela, vous spécifiez ces états à l'aide d'événements. Reportez-vous à Evénements intégrés pour le flux principal.)

En outre, vous pouvez utiliser le champ Groupe pour regrouper la brique avec d'autres briques associées. Le comportement de routage dans votre assistant numérique peut s'en trouver amélioré. L'affectation au groupe de briques peut être modifiée au niveau de l'assistant numérique. Reportez-vous à Groupes de briques.

Pour accéder à ces paramètres, procédez comme suit :

1. Cliquez sur pour ouvrir le menu latéral, sélectionnez Développement > Briques, puis ouvrez votre brique.

2. Dans la barre de navigation de gauche de la brique, cliquez sur et sélectionnez l'onglet Assistant numérique.

Pour supprimer une version d'une brique, cliquez sur l'icône Options associée et sélectionnez Supprimer.

Lorsque vous avez fini de créer une version, vous pouvez la verrouiller en la publiant. La seule modification que vous pouvez apporter à une brique publiée concerne les valeurs de paramètre personnalisé dans l'onglet Configuration. Si vous souhaitez apporter d'autres modifications, vous devez créer une autre version et travailler sur cette dernière.

Pour publier une version, procédez comme suit :

1. Si la brique comporte des intentions ou des questions/réponses, assurez-vous qu'elle a été entraînée. Vous devez l'entraîner pour pouvoir la publier.

2. Dans le catalogue de briques, localisez la version à publier.

3. Cliquez sur l'icône Options et sélectionnez Publier.

   La version de la brique dans le catalogue de briques affiche désormais une icône en forme de verrou pour indiquer qu'elle est publiée.

Si vous avez plusieurs instances Digital Assistant et si vous souhaitez copier une brique d'une instance vers une autre, utilisez les commandes Export et Import :

1. Connectez-vous à l'instance à partir de laquelle vous souhaitez exporter la brique.

2. Cliquez sur pour ouvrir le menu latéral et sélectionnez Développement > Briques.

3. Dans la mosaïque de la brique à exporter, cliquez sur et sélectionnez Exporter.

   Un fichier ZIP contenant la brique sera téléchargé en local vers votre système.

4. Connectez-vous à l'instance vers laquelle vous souhaitez exporter la brique.

5. Cliquez sur pour ouvrir le menu latéral et sélectionnez Développement > Briques.

6. Cliquez sur Importer une brique.

7. Téléchargez le fichier ZIP contenant la brique exportée.

8. Par défaut, les analyses sont désactivées pour les briques importées. Pour activer la génération de rapports d'analyse sur la brique importée, cliquez d'abord sur , puis sélectionnez Activer les analyses.

Une fois la brique créée et nommée, vous pouvez commencer le développement. Voici une vue d'ensemble du processus de développement.

Description de l'image bots-overall-process.png

1. Création des intentions : commencez par créer des intentions. Les intentions illustrent votre cas d'emploi en décrivant les différentes actions que la brique peut aider les utilisateurs à effectuer. Par exemple, si votre brique permet aux utilisateurs d'effectuer différentes transactions bancaires, vous pouvez créer des intentions comme CheckBalance ou TransferMoney. Les intentions ne décrivent pas seulement les actions que la brique peut effectuer, elles constituent également un élément clé de l'intelligence de votre brique. Elles permettent de reconnaître la saisie utilisateur car chacune d'entre elles est associée à un ensemble d'instructions utilisateur courantes appelées variations. Bien que ces expressions aient la même signification, elles améliorent la résilience de votre brique grâce à leur variété (par exemple, What’s my savings account balance? et How much is in my checking account?). Reportez-vous à Intentions.

2. Entraînement de la brique : pour que la brique puisse référencer des intentions lors de l'analyse des saisies utilisateur, vous devez l'entraîner. Plus précisément, vous devez l'entraîner à l'aide des intentions et de leurs variations (collectivement, les données d'entraînement), afin de pouvoir résoudre la saisie utilisateur en l'une des intentions. Lorsque vous entraînez votre brique, vous tirez parti de l'infrastructure décisionnelle linguistique. Son algorithme vous permet de reconnaître aussi bien les exemples d'expression appartenant à chaque intention que les expressions similaires. Reportez-vous à Entraînement et test des intentions.

3. Création des entités : dans certains cas, vous devrez peut-être fournir un contexte pour permettre à votre brique de répondre à une demande utilisateur. Même si certaines demandes utilisateur peuvent être résolues en la même intention (par exemple, What’s my savings account balance? et How much is in my checking account? seraient toutes deux résolues en l'intention CheckBalance), ce n'est pas pour autant qu'elles posent la même question. Pour clarifier la demande, vous pouvez ajouter une entité. Dans l'exemple d'une brique bancaire, une entité nommée AccountType définissant des valeurs appelées courant et épargne permettrait à la brique d'analyser la demande utilisateur et de répondre de manière appropriée. Reportez-vous à Entités.

4. Création du flux de dialogue : vous devez ensuite donner à la brique les moyens de transmettre ses compétences aux utilisateurs en créant le flux de dialogue. Ce flux de dialogue décrit la réaction de la brique lors de la résolution des différentes intentions. Il définit ce que la brique dit aux utilisateurs, comment elle les invite à saisir des informations et la façon dont elle renvoie des données. Reportez-vous à Concepteur de flux visuel.

5. Intégration des composants personnalisés : à ce stade, votre brique peut reconnaître la saisie, mais elle ne peut pas y répondre. Pour que l'intelligence de votre brique fonctionne, vous devez ajouter des composants. Les composants permettent à votre brique d'exécuter ses tâches. Il existe deux types de composant : ceux que nous fournissons pour la réalisation de certaines fonctions, qui vont de la conservation de l'intention résolue à partir du message utilisateur jusqu'à la génération de texte, et ceux que vous créez pour effectuer des tâches propres à une brique particulière, comme la vérification du solde d'un compte. Reportez-vous à Ajouter un package de composants à une brique.

6. Test de la brique : si vous avez démarré votre flux de dialogue, vous pouvez discuter avec votre brique afin de la tester.

7. (Facultatif) Acheminement vers des canaux pour la messagerie utilisateur et d'autres fonctionnalités : si votre brique n'est pas ajoutée à un assistant numérique, vous devrez l'ajouter à des canaux. Les utilisateurs peuvent discuter avec votre brique via diverses plates-formes de messagerie, applications de messagerie propriétaire et pages Web. Vous pouvez acheminer ces types de canal de messagerie utilisateur vers votre brique. La brique est exécutée de la même manière sur tous les types de canal, qu'ils soient de type texte uniquement ou qu'ils prennent en charge des cartes de défilement, des éléments d'interface utilisateur et des images. Outre ces canaux côté utilisateur, il existe d'autres types de canal : l'un d'eux relie votre brique à un système de support technique client et l'autre achemine les notifications d'une application externe qui invite la brique à initier une conversation.

8. Examen des rapports d'analyse : une fois que vous avez publié votre brique, vous pouvez examiner les rapports d'analyse pour savoir si les clients l'utilisent comme prévu. En fournissant des tendances de conversation et des mesures d'utilisation de haut niveau, des vues de chaque intention et leur parcours d'exécution ainsi que des transcriptions de conversation, ces rapports vous présentent sous différents angles l'efficacité avec laquelle la brique aide vos clients, ainsi que les situations dans lesquelles elle les empêche de mener à bien une tâche. Ces rapports vous permettent de repérer rapidement les zones à problème et vous suggèrent des saisies utilisateur pouvant améliorer la résolution des intentions de votre brique. Reportez-vous à Informations.

Au fil de vos itérations sur les définitions de flux de dialogue, les intentions, les entités et les assistants numériques, vous pouvez vérifier votre travail et appliquer les meilleures pratiques en cliquant sur Valider dans la bannière.

Description de l'illustration analyzer-dialog-flow-line.png
Pour les briques, la boîte d'affichage Résultats de validation répertorie les erreurs critiques () que vous devez corriger, les avertissements () et les conseils () qui vous indique où apporter d'éventuelles améliorations.

Skill confidence threshold is set to 0.4. We recommend to set the threshold to at least 0.7 to improve accuracy of intent matching.

Même si les messages de validation au niveau de la brique incluent les messages d'erreur, d'avertissement et de conseil, la validation au niveau de l'assistant numérique génère des messages d'avertissement pour les variations partagées par les briques inscrites dans l'assistant numérique.

Description de l'illustration analyseur-da-validate-message.png

Par exemple :

The utterance 'Cancel my order' is used in 2 intents: wineSkill, pizzaSkill. Duplicate utterances may cause ambiguity in the model.

Description de l'illustration analyseur-da-validation.png

Vous pouvez filtrer ces messages sur les avertissements ou les conseils. Vous pouvez masquer ou rouvrir la fenêtre Résultats de validation en cliquant sur Résultats.

Les noms suivants ne peuvent pas être utilisés pour les briques :

• type
• version