Création et configuration de compétences et ajout de nouvelles versions

Utilisez le catalogue des compétences, auquel vous accédez en cliquant sur Development > Skills (Développement > Compétences) dans le menu latéral, pour gérer le cycle de vie de vos compétences. Vous pouvez accéder à la plupart des tâches de gestion à partir du menu Options d'une compétence.

Note

Lorsque le commutateur Show Only Latest (Dernière seulement) est activé dans le catalogue des compétences, seule la version la plus récente de chaque compétence apparaît. Puisque les valeurs de version sont à structure libre, la page utilise la date de la dernière mise à jour pour déterminer la version la plus récente.

Description de bots-landing.png :
Description de l'illustration bots-landing.png

Création à partir de zéro

Vous pouvez créer une compétence en clonant une version d'une autre compétence ou en important une compétence, ou vous pouvez la créer à partir de zéro, comme décrit ci-après.

  1. Cliquez sur icône d'ouverture du menu latéral pour ouvrir le menu latéral, sélectionnez Development > Skills (Développement > Compétences) et cliquez sur New Skill (Nouvelle compétence).

  2. Dans la boîte de dialogue Create Skill (Créer une compétence), remplissez les champs obligatoires.

  3. Dans le champ Platform Version (Version de plate-forme), sélectionnez éventuellement une autre version de plate-forme.

    Ce paramètre affecte le comportement de vos compétences, par exemple, la façon dont le moteur de compréhension du langage naturel (NLU) résout les intentions. Par défaut, cette option est réglée à la version la plus récente de la plate-forme.

    Si vous avez spécifiquement besoin que le clone se comporte comme des compétences basées sur une autre version de plate-forme, sélectionnez cette version.

    Voir Version de plate-forme.

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

    Si vous prévoyez de concevoir la compétence pour plusieurs langues, examinez très attentivement votre choix. En particulier, si vous souhaitez prendre en charge d'autres langues que celles fournies, faites défiler vers le bas jusqu'à la section Service de traduction de la liste déroulante et sélectionnez-y anglais.

    Voir Langues et compétences pour des informations détaillées sur la conception de votre compétence pour les langues cibles souhaitées.

    Note

    Dans les versions 20.09 et inférieures de la plate-forme, vous ne spécifiez pas de langue principale. Au lieu de cela, une langue prédominante est automatiquement détectée si vous avez configuré un service de traduction pour la compétence.
  5. Cliquez sur Create (Créer).

Une fois créée, la compétence apparaît dans le catalogue en mode provisoire.

Clonage

Si vous souhaitez créer une compétence similaire à une compétence existante ou réutiliser les artefacts d'une compétence, vous pouvez utiliser le clonage.

Pour cloner une version d'une compétence :

  1. Dans le catalogue des compétences, localisez la version à cloner.

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

  3. Remplissez la boîte de dialogue en accordant une attention particulière à ces champs :
    • Version de plate-forme : La version de la plate-forme affecte le comportement de vos compétences, par exemple, la façon dont le moteur de compréhension du langage naturel (NLU) résout les intentions et les langues prises en charge de manière native.

      Si le clone doit spécifiquement se comporter comme la compétence de base, sélectionnez la version de la plateforme qu'elle utilise.

      Voir Version de plate-forme.

    • Langue principale : (Apparaît uniquement si la version de plate-forme sélectionnée est 20.12 ou supérieure.) Cela détermine à la fois la langue par défaut de la compétence et si cette langue sera prise en charge de manière native ou par l'intermédiaire d'un service de traduction.

      Si vous prévoyez de concevoir la compétence pour plusieurs langues, examinez très attentivement votre choix. En particulier, si vous souhaitez prendre en charge d'autres langues que celles fournies, faites défiler vers le bas jusqu'à la section Service de traduction de la liste déroulante et sélectionnez-y anglais.

      Voir Langues et compétences pour des informations détaillées sur la conception de votre compétence pour les langues cibles souhaitées.

      Note

      Dans les versions 20.09 et inférieures de la plate-forme, vous ne spécifiez pas de langue principale. Au lieu de cela, une langue prédominante est automatiquement détectée si vous avez configuré un service de traduction pour la compétence.
Note

Si la compétence utilise des services de composants intégrés, l'utilisation faite par le clone de chacun de ces services est comptabilisée dans le nombre de services de composants intégrés. Si cela entraîne un dépassement de la limite du nombre de services de composants intégrés pour votre instance (embedded-custom-component-service-count), Digital Assistant ne crée pas le clone. Si la limite est insuffisante, vous pouvez demander une augmentation. Pour plus d'informations, voir Voir les limites de service dans la console d'infrastructure et Demande d'une augmentation de limite de service. Les services de composants intégrés dans les compétences qui sont téléchargés à partir du magasin de compétences ne sont pas comptés.

Création par importation

Vous pouvez créer une compétence en important une version d'une autre compétence exportée à partir d'une instance différente. La compétence importée sera en mode provisoire, même si elle a été publiée dans l'instance source.

Pour importer une version d'une compétence :

  1. Dans le catalogue des compétences, cliquez sur Import Skill (Importer une compétence).

  2. Chargez le fichier ZIP contenant la compétence exportée.

  3. Par défaut, les données clés sont désactivées pour les compétences importées. Pour activer les rapports de données clés de la compétence importée, cliquez d'abord sur icône des paramètres, puis sélectionnez Enable Insights (Activer les données clés).

Conseil :

Si vous voulez exporter une version, apporter des modifications aux fichiers exportés, puis les importer dans la même instance, n'oubliez pas de modifier la version. Sinon, Digital Assistant ne permet pas l'importation.
Note

Si la compétence utilise des services de composants intégrés, l'utilisation faite par la compétence importée de chacun de ces services est comptabilisée dans le nombre de services de composants intégrés. Si cela entraîne un dépassement de la limite du nombre de services de composants intégrés pour votre instance (embedded-custom-component-service-count), Digital Assistant n'importe pas la compétence. Si la limite est insuffisante, vous pouvez demander une augmentation. Pour plus d'informations, voir Voir les limites de service dans la console d'infrastructure et Demande d'une augmentation de limite de service. Les services de composants intégrés dans les compétences qui sont téléchargés à partir du magasin de compétences ne sont pas comptés.

Création d'une nouvelle version

À un certain moment, vous voudrez peut-être créer une autre version d'une compétence, notamment pour ajouter de nouvelles fonctions.

Pour créer une autre version :

  1. Dans le catalogue de compétences, localisez la version dont vous voulez créer une autre version.

  2. Cliquez sur l'icône Options, puis sélectionnez New Version (Nouvelle version).

  3. Remplissez la boîte de dialogue en accordant une attention particulière à ces champs :
    • Version de plate-forme : La version de la plate-forme affecte le comportement de vos compétences, par exemple, la façon dont le moteur de compréhension du langage naturel (NLU) résout les intentions et les langues prises en charge de manière native.

      Si cette version de la compétence doit spécifiquement se comporter comme la précédente, sélectionnez la version de la plateforme utilisée par la compétence de base.

      Voir Version de plate-forme.

    • Langue principale : (Apparaît uniquement si la version de plate-forme sélectionnée est 20.12 ou supérieure.) Cela détermine à la fois la langue par défaut de la compétence et si cette langue sera prise en charge de manière native ou par l'intermédiaire d'un service de traduction.

      Si vous prévoyez de concevoir la compétence pour plusieurs langues, examinez très attentivement votre choix. En particulier, si vous souhaitez prendre en charge d'autres langues que celles fournies, faites défiler vers le bas jusqu'à la section Service de traduction de la liste déroulante et sélectionnez-y anglais.

      Voir Langues et compétences pour des informations détaillées sur la conception de votre compétence pour les langues cibles souhaitées.

      Note

      Dans les versions 20.09 et inférieures de la plate-forme, vous ne spécifiez pas de langue principale. Au lieu de cela, une langue prédominante est automatiquement détectée si vous avez configuré un service de traduction pour la compétence.
Note

Si la compétence utilise des services de composants intégrés, l'utilisation faite par la version de chacun de ces services est comptabilisée dans le nombre de services de composants intégrés. Si cela entraîne un dépassement de la limite du nombre de services de composants intégrés pour votre instance (embedded-custom-component-service-count), Digital Assistant ne crée pas la version. Si la limite est insuffisante, vous pouvez demander une augmentation. Pour plus d'informations, voir Voir les limites de service dans la console d'infrastructure et Demande d'une augmentation de limite de service. Les services de composants intégrés dans les compétences qui sont téléchargés à partir du magasin de compétences ne sont pas comptés.

Mode de dialogue

Lorsque vous créez une compétence, 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 vignettes pour chaque état et 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 dialogues 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 utilisateur-compétence dans un langage de balisage simple qui vous permet de décrire une boîte de dialogue à la fois en fonction de ce que dit votre compétence et de ce qu'elle fait. L'ensemble de la définition du flux de dialogue est défini dans un seul fichier.

Configuration pour une utilisation dans un assistant numérique

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

  • Invocation Name (Nom d'appel) : Il s'agit du nom avec lequel l'utilisateur peut appeler explicitement la compétence dans l'assistant numérique.

    Voir Directives relatives aux noms d'appel.

  • Example Utterances (Exemples d'énoncés) : Ils permettent au moteur d'intention de déterminer quand l'utilisateur souhaite appeler la compétence. Dans les exemples, il est préférable d'inclure le nom d'appel pour améliorer la mise en correspondance des énoncés de l'utilisateur et de la compétence.

    Les premiers énoncés figurent également sur la carte de la compétence que l'assistant numérique fournit par défaut pour les états d'accueil et d'aide.

Pour les compétences développées en mode YAML, vous pouvez éventuellement spécifier les paramètres État de début, État de bienvenue et État de l'aide. Voir États de début, de bienvenue et d'aide. (Pour les compétences développées en mode visuel, ces paramètres ne sont pas disponibles. Vous définissez plutôt ces états à l'aide d'événements. Voir Événements intégrés pour le flux principal.)

En outre, vous pouvez utiliser le champ Groupe pour regrouper la compétence avec d'autres compétences connexes. Cela peut améliorer le comportement de routage dans votre assistant numérique. L'affectation du groupe de compétences peut être modifiée au niveau de l'assistant numérique. Voir Groupes de compétences.

Pour accéder à ces paramètres :

  1. Cliquez sur icône d'ouverture du menu latéral pour ouvrir le menu latéral, sélectionnez Development > Skills (Développement > Compétences) et ouvrez votre compétence.

  2. Dans la barre de navigation gauche de la compétence, cliquez sur icône Settings (Paramètres) et sélectionnez l'onglet Digital Assistant.

Suppression

Pour supprimer une version d'une compétence, cliquez sur son icône Options, puis sélectionnez Delete (Supprimer).

Publication

Lorsque vous avez terminé de créer une version, vous pouvez la verrouiller en la publiant. Une fois une compétence publiée, vous ne pouvez modifier que les valeurs de paramètres personnalisés dans l'onglet Configuration. Si vous voulez apporter d'autres modifications, vous devez créer une autre version et travailler sur celle-ci.

Pour publier une version :

  1. Si la compétence comprend des intentions ou des FAQ, assurez-vous qu'elle a été entraînée. Vous devez l'entraîner avant de la publier.
  2. Dans le catalogue des compétences, localisez la version que vous voulez publier.

  3. Cliquez sur l'icône Options, puis sélectionnez Publish (Publier).

    Dans le catalogue, cette version de la compétence présente maintenant une icône de verrouillage indiquant qu'elle a été publiée.

Exporter une compétence vers une autre instance

Si vous avez plusieurs instances Digital Assistant et que vous voulez copier une compétence d'une instance à une autre, utilisez les commandes d'exportation et d'importation :

  1. Connectez-vous à l'instance à partir de laquelle vous voulez exporter la compétence.

  2. Cliquez sur icône d'ouverture du menu latéral pour ouvrir le menu latéral et sélectionnez Development > Skills (Développement > Compétences).

  3. Dans la vignette de la compétence à exporter, cliquez sur icône d'ouverture du menu Options et sélectionnez Export (Exporter).

    Un fichier zip contenant la compétence est téléchargé sur votre système.

  4. Connectez-vous à l'instance vers laquelle vous souhaitez exporter la compétence.

  5. Cliquez sur icône d'ouverture du menu latéral pour ouvrir le menu latéral et sélectionnez Development > Skills (Développement > Compétences).

  6. Cliquez sur Import Skill (Importer une compétence).

  7. Chargez le fichier ZIP contenant la compétence exportée.

  8. Par défaut, les données clés sont désactivées pour les compétences importées. Pour activer les rapports de données clés de la compétence importée, cliquez d'abord sur icône des paramètres, puis sélectionnez Enable Insights (Activer les données clés).
Note

La compétence importée sera en mode provisoire, même si elle a été publiée dans l'instance source.

Processus de développement d'une compétence

Une fois la compétence créée et nommée, vous pouvez commencer le développement. Voici une vue d'ensemble du processus de développement.
  1. Créer des intentions—Commencez par créer des intentions. Les intentions définissent un cas d'utilisation en décrivant les diverses actions que la compétence aide les utilisateurs à effectuer. Par exemple, si votre compétence permet aux utilisateurs d'effectuer différentes transactions bancaires, vous pouvez créer des intentions telles que CheckBalance (Consultation de solde) ou TransferMoney (Transfert d'argent). Les intentions ne servent pas seulement à décrire ce qu'une compétence peut faire. Elles sont l'élément clé de l'intelligence de la compétence en lui permettant d'interpréter les entrées des utilisateurs. Chaque intention est associée à un ensemble de déclarations typiques appelées énoncés. Bien que ces expressions aient la même signification, elles renforcent votre compétences car elles sont variées (par exemple, Quel est le solde de mon compte d'épargne? et Combien ai-je sur mon compte de chèques?). Voir Intentions.

  2. Entraîner la compétence—Vous devez entraîner votre compétence à identifier les intentions lors de l'analyse des entrées de l'utilisateur. Plus précisément, vous devez l'entraîner avec les intentions et les énoncés correspondants (les données d'entraînement) afin qu'elle puisse définir l'intention de chaque entrée de l'utilisateur. L'entraînement de votre compétence exploite le cadre d'intelligence linguistique. Ses algorithmes permettent à votre compétence non seulement de reconnaître les exemples d'expressions associés à chaque intention, mais aussi les phrases similaires. Voir Entraînement et test des intentions.

  3. Créer des entités— Dans certains cas, vous devrez peut-être fournir un contexte pour permettre à votre compétence d'exécuter une demande de l'utilisateur. Même si certaines demandes de l'utilisateur peuvent être associées à la même intention (par exemple, les énoncés Quel est le solde de mon compte d'épargne? et Combien ai-je sur mon compte de chèques? correspondent à l'intention CheckBalance (Consultation de solde)), elles demandent des choses différentes. Pour clarifier la demande, vous pouvez ajouter une entité. Dans l'exemple de la compétence bancaire, il est possible d'ajouter une entité nommée AccountType (Type de compte), qui définit des valeurs appelées chèques et épargne. Cette entité permet à la compétence d'analyser la demande de l'utilisateur et d'y répondre de manière appropriée. Voir Entités.

  4. Créer le flux de dialogue— Vous donnez ensuite à la compétence les moyens d'exprimer son intelligence aux utilisateurs en créant le flux de dialogue. Celui-ci décrit la réaction de votre compétence au fur et à mesure de l'identification des différentes intentions. Il définit ce que la compétence indique l'utilisateur, la manière dont elle l'invite a entrer quelque chose et dont elle retourne des données. Voir Concepteur de flux visuel.

  5. Intégrer des composants personnalisés—À ce stade, votre compétence est capable de reconnaître l'entrée, mais ne peut pas y répondre. Pour faire fonctionner l'intelligence de votre compétence, vous devez ajouter des composants. Les composants permettent à la compétence d'effectuer son travail. Il existe deux types de composant : les composants que nous fournissons, qui appliquent des fonctions allant de la prise en compte de l'intention identifiée à partir du message de l'utilisateur à la sortie de texte, et les composants que vous créez pour exécuter des tâches propres à une compétence particulière, telles que la vérification du solde d'un compte. Voir Ajouter un ensemble de composants à une compétence.

  6. Tester la compétence—Après avoir démarré le flux de dialogue, vous pouvez clavarder avec votre compétence pour la tester.

  7. (Facultatif) Associer la compétence à des canaux pour la messagerie et d'autres fonctions—Si votre compétence n'est pas destinée à un assistant numérique, vous devez l'ajouter à un ou plusieurs canaux. Les utilisateurs peuvent clavarder avec votre compétence depuis des plates-formes de messagerie diverses, des applications de messagerie propriétaires et des pages Web. Vous pouvez associer un ou plusieurs de ces canaux de messagerie utilisateur à votre compétence. Tous les canaux offrent les mêmes fonctionnalités, qu'ils soient textuels ou prennent en charge les cartes de défilement, les éléments d'interface utilisateur et les images. En complément de ces canaux d'échange avec les utilisateurs, il en existe deux autres : l'un associe votre compétence à un système de soutien à la clientèle et l'autre achemine les avis provenant d'une application externe qui invite la compétence à lancer une conversation.

  8. Consulter les rapports de données clés—Une fois votre compétence publiée, vous pouvez consulter les rapports de données clés pour déterminer si les clients utilisent la compétence comme prévu. Les rapports fournissent des mesures d'utilisation générales, les tendances des conversations, des vues individuelles des intentions, les chemins d'exécution et la transcription des conversation. Vous disposez ainsi de différents points de vue sur la façon dont votre compétence répond aux clients et sur les points de blocage éventuels. Ces rapports ne se limitent pas à signaler les points problématiques. Ils suggèrent des entrées utilisateur susceptibles d'améliorer la résolution d'intention par la compétence. Voir Données clés.

Valider votre travail

Lorsque vous itérez à travers vos définitions de flux de dialogue, intentions, entités et assistants numériques, vous pouvez vérifier votre travail et appliquer les meilleures pratiques en cliquant sur Valider dans la bannière.
Description d'analyzer-dialog-flow-line.png :
Description de l'illustration analyzer-dialog-flow-line.png

Pour les compétences, la boîte de dialogue Validation des résultats liste les erreurs critiques Ceci est une image de l'icône d'avertissement. que vous devez corriger, les avertissements Ceci est une image de l'icône d'erreur. et les conseils Ceci est une image de l'icône de conseil. qui soulignent les endroits où vous pouvez avoir besoin d'apporter des améliorations.

Certains de ces messages sont généraux, tandis que d'autres citent l'entité, l'intention ou la ligne dans la définition du flux de dialogue. Bien que les messages d'erreur signalent des problèmes qui empêchent la compétence de fonctionner, comme des références de variable incorrectes dans la définition du flux de dialogue, vous pouvez utiliser les messages d'avertissement et de conseil pour documenter votre développement. Ces messages peuvent vous aider lors de votre développement initial, mais ils peuvent être particulièrement utiles lorsque vous travaillez sur une compétence créée par une autre équipe de développement, surtout s'il s'agissait d'une version antérieure d'Oracle Digital Assistant. Par exemple, si vous mettez à niveau une compétence qui utilise le seuil de confiance précédemment recommandé de 0,4, un message vous recommandera le seuil courant à la place. Par exemple :
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.
Alors que les messages de validation au niveau de la compétence comprennent des messages d'erreur, d'avertissement et de conseil, la validation au niveau de l'assistant numérique consiste en des messages d'avertissement pour les énoncés partagés par les compétences enregistrées auprès de l'assistant numérique.

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


Vous pouvez filtrer ces messages par avertissements ou conseils. Vous pouvez masquer ou rouvrir la boîte de dialogue Validation des résultats en cliquant sur ConclusionsCeci est une image de l'icône Voir les constatations de validation. Vous pouvez également filtrer ces messages par avertissement et conseils..

Noms que vous ne pouvez pas utiliser pour les aptitudes

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

  • type
  • version