Documentation Oracle Cloud Infrastructure

Extension d'assistants numériques et de briques

Vous pouvez étendre n'importe quel assistant numérique ou n'importe quelle brique extraite de la banque de briques à des fins de personnalisation afin de gérer des cas propres à votre entreprise. Lorsqu'une nouvelle version apparaît dans la banque de briques, vous pouvez transférer vos personnalisations vers la nouvelle version par rebasage.

Remarque

L'extension d'assistants numériques n'est pas prise en charge pour les versions antérieures à 20.6.

Qu'est-ce que l'extension et à quoi sert-elle ?

Lorsque vous installez des bots (assistants numériques et briques) à partir de la banque de briques, ils peuvent ne pas répondre à toutes vos exigences ou vous voulez peut-être les modifier pour les aligner sur vos processus métier. Vous ne pouvez pas modifier directement un bot installé, mais vous pouvez en créer une extension, puis modifier cette extension.

Lorsque vous créez une extension, vous créez un bot en relation étroite avec le bot d'origine (de base). Grâce à cette relation, vous pouvez par la suite profiter des mises à jour du bot de base sans avoir à réappliquer manuellement vos personnalisations. Pour ce faire, utilisez la fonctionnalité de rebasage. Lorsqu'une nouvelle version du bot de base devient disponible dans la banque de briques, vous pouvez installer cette version dans votre instance, puis rebaser votre bot étendu sur la version de base mise à jour.

Remarque

Lorsque vous étendez un bot, vous pouvez ajouter des propriétés ou modifier les propriétés existantes sur le bot. En revanche, vous ne pouvez supprimer aucune propriété définie dans le bot de base.

Clonage et extension

Bien que le clonage et l'extension soient similaires en apparence, ils présentent des différences clés et des objectifs divers :

  • Lorsque vous créez un clone d'un bot :
    • Vous créez une copie totalement indépendante du bot.
    • Vous pouvez apporter des modifications illimitées au clone.
    • Le clone perd toute association avec le bot d'origine (les ID de suivi du bot cloné ne correspondent pas à ceux du bot d'origine) : vous ne pouvez pas le rebaser ultérieurement sur une version mise à jour du bot d'origine.

    Ayez recours au clonage lorsque vous voulez utiliser un bot existant comme point de départ pour votre développement.

  • Lorsque vous étendez un bot (une brique ou un assistant numérique) :
    • Vous pouvez effectuer un large éventail d'ajouts et de modifications sur le bot étendu, mais vous ne pouvez rien supprimer de ce qui a été défini dans le bot de base.
    • Vous pouvez le rebaser ultérieurement, soit appliquer les mises à jour du bot de base au bot étendu.

      Le rebasage est possible pour les bots étendus car les ID de suivi interne générés pour eux correspondent à ceux des bots de base.

    Utilisez l'extension pour personnaliser un bot et pouvoir incorporer ultérieurement des améliorations ou de nouvelles fonctionnalités à partir du bot de base dans votre version personnalisée. Vous pouvez uniquement étendre les briques et les assistants numériques que vous avez extraits de la banque de briques.

Remarque

Une troisième approche consiste à étendre un bot, à le personnaliser, puis à créer un clone du bot étendu. Dans ce cas de figure, le clone du bot étendu est également traité comme une extension du bot d'origine (les ID de suivi interne générés pour le clone de l'extension correspondent à ceux du bot d'origine).

Conséquences de l'extension d'une brique ou d'un assistant numérique

Lorsque vous étendez un bot (qu'il s'agisse d'une brique ou d'un assistant numérique), chacune des parties du bot (telles que les intentions, les entités et les propriétés) possède l'un des statuts suivants :

  • Hérité (Icône Hérité de la brique de base sans personnalisation) : artefacts définis dans le bot de base. Une fois que vous avez créé une extension, tous les artefacts du bot ont ce statut.
  • Local : artefacts créés dans l'extension (par exemple, nouvelles intentions).
  • Personnalisé (Icône Hérité de la brique de base avec personnalisations) : artefacts hérités du bot de base dont les valeurs ont été modifiées dans l'extension.

Lorsque vous étendez une brique, les filtres associés à ces statuts apparaissent dans l'onglet Intentions au-dessus de la liste des intentions et au-dessus de la liste des exemples.

Lorsque vous étendez un assistant numérique, les filtres associés à ces statuts apparaissent au-dessus de la liste des briques (dans l'onglet Briques) et au-dessus de la liste des exemples (dans l'onglet Intentions).

Remarque

Vous ne pouvez pas supprimer les artefacts (tels que des briques dans des assistants numériques, et des intentions et des entités dans des briques), mais vous pouvez les désactiver.

Remarque importante pour les développeurs de bots de base

Si vous êtes développeur d'une brique ou d'un assistant numérique qui a été téléchargé vers la banque de briques et que vous devez mettre à jour ce bot dans la banque de briques, vous devez créer la version mise à jour via l'option Nouvelle version afin que les utilisateurs puissent rebaser leurs versions étendues sur la version de base mise à jour. Si vous clonez le bot existant ou créez simplement un bot portant le même nom, les ID de suivi interne générés pour le nouveau bot sont différents de ceux du bot existant. Il n'existe donc aucune corrélation entre les bots.

Briques

Voici ce que vous devez savoir sur l'extension de briques que vous avez extraites de la banque de briques.

Extension d'une brique

  1. Cliquez sur icône permettant d'ouvrir le menu latéral pour ouvrir le menu latéral et sélectionnez Développement > Briques.

  2. Dans la mosaïque de la brique à étendre, cliquez sur l'icône Options (icône du menu Options), puis sélectionnez Etendre.

    Vous devez avoir extrait cette brique de la banque de briques.

Ce que vous pouvez ajouter et personnaliser dans une brique étendue

  • Intentions. Vous pouvez ajouter des variations, modifier des variations existantes et ajouter de nouvelles intentions. Vous ne pouvez pas supprimer des variations ou des intentions, mais vous pouvez désactiver des intentions.
  • Entités. Vous pouvez ajouter des valeurs d'entité, ajouter des synonymes aux valeurs d'entité et ajouter de nouvelles entités. Vous pouvez également modifier les champs suivants :
    • Taille de plage d'énumération
    • Message d'erreur
    • Valeurs multiples
    • Correspondance partielle

    Toutefois, vous ne pouvez pas supprimer des entités, ni supprimer ou modifier des valeurs d'entité.

  • Flux de dialogue. Vous pouvez apporter des modifications dans tout le flux de dialogue. Il n'existe aucune restriction spécifique. Toutefois, aucun delta n'est suivi par le système. Lorsque vous rebasez l'extension de brique, un outil de différenciation apparaît pour comparer le flux de dialogue côte à côte avec celui de la nouvelle brique de base. Vous devez ensuite déterminer les éléments à conserver dans votre brique et les éléments à mettre en avant dans la nouvelle brique de base.
  • Groupes de ressources. Vous pouvez :
    • ajouter de nouvelles clés de message dans toutes les langues prises en charge,
    • modifier les messages existants.
  • Service de composant personnalisé. Vous pouvez :
    • remplacer le fichier de package,
    • ajouter des composants au service.

    Vous ne pouvez pas :

    • enlever des composants.

    Vous pouvez modifier l'implémentation des composants personnalisés dans votre brique étendue. Toutefois, si le composant personnalisé est mis à jour ultérieurement dans la brique de base, ces mises à jour ne seront pas fusionnées avec les modifications apportées au composant dans la brique étendue lorsque vous rebasez votre brique. Dans ce cas, vous devez fusionner manuellement les modifications apportées au composant personnalisé à partir de la brique de base mise à jour vers votre brique étendue.

  • Paramètres. Vous pouvez ajuster la plupart des paramètres pour la brique, notamment :
    • les propriétés générales, telles que la description d'une brique,
    • le modèle d'entraînement,
    • choisir d'activer ou non les analyses et la journalisation des conversations,
    • les valeurs des paramètres système, telles que le seuil de confiance et les invites standard,
    • les paramètres personnalisés (Vous pouvez créer des paramètres personnalisés et modifier les valeurs des paramètres existants.),
    • les valeurs des propriétés de l'assistant numérique, telles que l'appel, les exemples de variation, l'état de début, l'état de bienvenue et l'état d'aide.

Modifications non conservées lors du rebasage

  • Questions/réponses. Vous pouvez modifier le contenu d'un module de questions/réponses dans une brique étendue, mais ces modifications sont supprimées si vous rebasez la brique par la suite.

    Si vous avez modifié un module de questions/réponses dans votre brique étendue, veillez à exporter le fichier source de questions/réponses avant le rebasage.

    Remarque

    Cette limitation ne s'applique pas aux intentions de réponse.

Désactivation d'intentions

Lorsque vous étendez une brique, vous ne pouvez pas enlever des intentions, mais vous pouvez les désactiver.

Lorsque vous désactivez une intention, vous l'excluez du modèle d'entraînement. Toute entrée utilisateur qui, dans d'autres circonstances, correspondrait bien aux données d'entraînement d'une intention désactivée est résolue en intention différente (probablement unresolvedIntent).

Si vous rebasez ultérieurement la brique, toutes les intentions que vous avez désactivées restent désactivées. Si vous réactivez une intention après le rebasage, vous récupérez les modifications apportées à cette intention dans la brique de base.

Pour désactiver une intention, procédez comme suit :

  1. Dans la barre de navigation de gauche de la brique étendue, cliquez sur Il s'agit d'une image de l'icône Intention..
  2. Sélectionnez l'intention à désactiver.
  3. Passez le commutateur Activé de l'intention en position Désactivé.
  4. Cliquez sur le bouton Entraîner dans l'angle supérieur droit de la page, puis sur Soumettre.
Remarque

Si vous voulez exclure la fonctionnalité d'une intention d'une brique tout en informant l'utilisateur que la fonctionnalité de l'intention n'est pas disponible, laissez l'intention activée, mais entrez une réponse statique dans le champ Réponse de l'intention. Si vous procédez ainsi, ce texte apparaît lorsque l'entrée de l'utilisateur est résolue en cette intention. Pour plus d'informations sur le fonctionnement de ce processus, reportez-vous à Intentions de réponse.

Assistants numériques

Voici ce que vous devez savoir sur l'extension d'assistants numériques que vous avez extraits de la banque de briques.

Extension d'un assistant numérique

  1. Cliquez sur icône permettant d'ouvrir le menu latéral pour ouvrir le menu, latéral et sélectionnez Développement > Assistants numériques.

  2. Dans la mosaïque de l'assistant numérique à étendre, cliquez sur l'icône Options (icône du menu Options), puis sélectionnez Etendre.

    Vous devez avoir extrait cet assistant numérique de la banque de briques.

Ce que vous pouvez ajouter et personnaliser dans un assistant numérique étendu

  • Briques. Vous pouvez ajouter d'autres compétences. Vous ne pouvez pas supprimer les briques héritées de l'assistant numérique de base mais vous pouvez les désactiver.
  • Intentions système. Pour les intentions exit, help et unresolvedIntents, vous pouvez ajouter des variations et modifier les variations existantes.
  • Paramètres. Vous pouvez ajuster la plupart des paramètres de l'assistant numérique, notamment les suivants :
    • Propriétés générales, telles que la description de l'assistant numérique
    • le modèle d'entraînement,
    • Activation des analyses
    • Paramètres d'acheminement, tels que les différents seuils de confiance et invites standard.
    • les paramètres personnalisés Vous pouvez créer des paramètres personnalisés et modifier les valeurs des paramètres existants.

Désactivation de briques

Lorsque vous étendez un assistant numérique, vous ne pouvez pas enlever des briques, mais vous pouvez les désactiver.

Lorsque vous désactivez une brique, vous l'excluez du modèle d'entraînement. Toute entrée utilisateur qui, dans d'autres circonstances, correspondrait bien aux données d'entraînement de la brique est résolue ailleurs (probablement unresolvedIntent de l'assistant numérique).

Si vous rebasez ultérieurement l'assistant numérique, toutes les briques que vous avez désactivées restent désactivées. Si vous réactivez une brique après le rebasage, vous récupérez les modifications apportées à cette brique dans l'assistant numérique de base.

Pour désactiver une brique, procédez comme suit :

  1. Dans la barre de navigation de gauche de l'assistant numérique, cliquez sur image de l'icône Briques.
  2. Sélectionnez la brique à désactiver.
  3. Passez le commutateur Activé de la brique en position Désactivé.

Mise à jour d'une brique dans un assistant numérique étendu

Si vous disposez d'un assistant numérique étendu qui contient une brique avec une version plus récente installée dans votre instance, vous pouvez mettre à jour l'assistant numérique afin qu'il utilise cette version.

  1. Cliquez sur icône permettant d'ouvrir le menu latéral pour ouvrir le menu, latéral et sélectionnez Développement > Assistants numériques.

  2. Cliquez sur la mosaïque de l'assistant numérique pour l'ouvrir.

  3. Dans l'onglet Briques de l'assistant numérique, sélectionnez la brique à remplacer par une version plus récente.

    La brique doit comporter le badge Mise à jour disponible.

  4. Cliquez sur Mettre à jour la brique.

  5. Dans la liste déroulante Nouvelle version de brique, sélectionnez la version de la brique à inclure, puis cliquez sur Mettre à jour la brique.

  6. Définissez le commutateur Ecraser le modèle d'interaction.

    Si vous voulez que les modifications apportées aux propriétés Appel et Exemples de variation définies dans l'onglet Assistant numérique de la page Paramètres de la brique soient propagées vers l'assistant numérique, laissez ce commutateur en position Activé.

    Ces valeurs sont utilisées dans la carte d'aide pour la brique dans l'assistant numérique.

  7. Cliquez sur Mettre à jour la brique.

Extension d'une brique dans un assistant numérique étendu

Si vous avez étendu un assistant numérique et que vous voulez remplacer l'une de ses briques de base par une version étendue de cette brique, vous devez appliquer les étapes générales suivantes :

  1. Etendez la brique et effectuez les personnalisations voulues.
  2. Entraînez la brique.

    (Vous devez entraîner une brique pour pouvoir la publier.)

  3. Dans l'assistant numérique, mettez à jour la version de la brique qu'il utilise en effectuant les opérations suivantes :

    1. Cliquez sur icône permettant d'ouvrir le menu latéral pour ouvrir le menu, latéral et sélectionnez Développement > Assistants numériques.

    2. Cliquez sur la mosaïque de l'assistant numérique pour l'ouvrir.

    3. Dans l'onglet Briques de l'assistant numérique, sélectionnez la brique que vous avez étendue. Cette brique doit comporter le badge Mise à jour disponible.

    4. Cliquez sur Mettre à jour la brique.

    5. Dans la liste déroulante Nouvelle version de brique, sélectionnez la version étendue de la brique, puis cliquez sur Mettre à jour la brique.

  4. Une fois que vous avez testé l'assistant numérique avec la nouvelle version de la brique et que vous avez été satisfait de son comportement, publiez la brique.

Ajout, examen et rétablissement de personnalisations

Vous pouvez ajouter des éléments à un bot étendu (brique ou assistant numérique) ou le personnaliser à l'aide de l'un de ses contrôles activés et de ses champs modifiables.

Vous pouvez examiner les personnalisations effectuées dans un bot en cliquant sur l'icône Icône Examiner qui apparaît en regard du champ personnalisé. (Pour les exemples de variation d'une intention, vous devez déplacer la souris sur l'icône Icône Hérité de la brique de base avec personnalisations en regard de la variation pour afficher l'icône Icône Examiner.

Lorsque vous cliquez sur cette icône, la boîte de dialogue Examiner la personnalisation apparaît. Elle vous permet de comparer la valeur en cours du champ à la valeur de base. Pour rétablir la valeur du bot de base, cliquez sur Rétablir à la valeur d'origine.

Test des personnalisations

Vous pouvez utiliser la fonctionnalité de cas de test pour vous assurer que les modifications que vous avez apportées dans vos extensions n'ont perturbé aucune des fonctions de base du bot.

Vous pouvez créer les tests en enregistrant des conversations dans le testeur. En outre, certaines briques et certains assistants numériques dans la banque de briques sont fournis avec des cas de test, que vous pouvez exécuter sur vos extensions pour vous assurer que vous n'avez perturbé aucune fonctionnalité.

Pour plus de détails sur la création et l'utilisation de cas de test, reportez-vous à Suites de tests et scénarios de test.

Rebasage

Si une nouvelle version de base d'un bot que vous avez étendu est disponible, vous pouvez rebaser le bot étendu de sorte qu'il récupère les modifications apportées au bot de base et conserve les personnalisations apportées au bot étendu. Le rebasage est disponible à la fois pour les briques et les assistants numériques.

Vous pouvez également effectuer le rebasage sur n'importe quelle version du bot qui descend du bot d'origine, qu'il s'agisse d'une version du bot d'origine ou d'une version étendue du bot. (Cela ne s'applique pas aux clones ou aux bots créés séparément mais portant le même nom.)

Fonctionnement du rebasage

En cas de rebasage, les événements suivants se produisent dans le bot étendu :

  • Une nouvelle version de l'extension est créée.
  • Tous les nouveaux artefacts (tels que les nouvelles intentions) de la nouvelle version du bot de base (c'est-à-dire ceux qui ont été ajoutés après la création ou le dernier rebasage de l'extension) sont ajoutés à l'extension.
  • Tous les artefacts locaux (ceux créés dans l'extension) sont conservés dans l'extension.
  • Toutes les personnalisations des artefacts (telles que les modifications des valeurs de propriété) sont conservées.
    Remarque

    Les valeurs de propriété personnalisées priment toujours sur les modifications apportées au bot de base. Pour utiliser les valeurs de la nouvelle base, vous pouvez annuler les modifications une fois le processus de rebasage terminé.
  • Tous les artefacts hérités inclus dans la version en cours du bot de base qui n'ont pas été personnalisés et qui ont été enlevés de la nouvelle version du bot de base sont supprimés.

    Les artefacts personnalisés qui n'existent plus dans le nouveau bot de base sont inclus dans l'extension rebasée. Dans l'extension, ils sont traités comme des artefacts locaux, afin que vous puissiez les supprimer si vous n'en avez plus besoin.

Attention :

Si la nouvelle version du bot de base et l'extension comportent un nouvel artefact avec la même clé (généralement, son nom), le rebasage ne peut pas résoudre les deux et échoue. Dans ce cas, vous devez supprimer la version locale de l'artefact pour pouvoir effectuer le rebasage.

Rebasage d'une extension de brique

  1. Sinon, installez la brique mise à jour :
    1. Cliquez sur icône permettant d'ouvrir le menu latéral pour ouvrir le menu latéral et sélectionnez Développement > Banque.
    2. Dans la mosaïque de la brique de base mise à jour, cliquez sur icône permettant d'ouvrir le menu Options et sélectionnez Extraire.
  2. Cliquez sur icône permettant d'ouvrir le menu latéral pour ouvrir le menu latéral, sélectionnez Développement > Briques et cliquez sur la mosaïque de la version étendue de la brique pour l'ouvrir.
  3. Dans la barre de navigation de gauche de la brique, cliquez sur Icône Paramètres.
  4. Cliquez sur le bouton Rebaser.
  5. Dans la liste déroulante Brique de base, sélectionnez la version de brique que vous rebasez, puis cliquez sur Suivant.
  6. Terminez l'assistant.

Si le rebasage est effectué, la nouvelle version rebasée de la brique est créée et ouverte en mode brouillon.

En cas d'échec du rebasage, un message d'erreur apparaît indiquant ce qui a bloqué le rebasage, et que la nouvelle version de la brique étendue n'a pas été créée.

Rebasage d'une extension d'assistant numérique

  1. Si ce n'est déjà fait, installez l'assistant numérique mis à jour :
    1. Cliquez sur icône permettant d'ouvrir le menu latéral pour ouvrir le menu latéral et sélectionnez Développement > Banque.
    2. Dans la mosaïque de l'assistant numérique de base mis à jour, cliquez sur icône permettant d'ouvrir le menu Options et sélectionnez Extraire.
  2. Cliquez sur icône permettant d'ouvrir le menu latéral pour ouvrir le menu latéral, sélectionnez Développement > Assistants numériques et cliquez sur la mosaïque de la version étendue de l'assistant numérique pour l'ouvrir.
  3. Dans la barre de navigation de gauche de l'assistant numérique, cliquez sur Icône Paramètres.
  4. Cliquez sur le bouton Rebaser.
  5. Dans la liste déroulante Assistant numérique de base, sélectionnez la version de brique que vous rebasez, puis cliquez sur Suivant.
  6. Terminez l'assistant.

Si le rebasage est effectué, la nouvelle version rebasée de l'assistant numérique est créée et ouverte en mode brouillon.

En cas d'échec du rebasage, un message d'erreur apparaît indiquant ce qui a bloqué le rebasage, et que la nouvelle version de l'assistant numérique étendu n'a pas été créée.

Que faire en cas d'échec de rebasage ?

En cas d'échec du rebasage d'une brique ou d'un assistant numérique, voici les étapes nécessaires pour réessayer :

  1. Créez une nouvelle version de l'extension de bot.
  2. Apportez des modifications à l'extension pour corriger les erreurs lors de la tentative de rebasage. Cela peut simplement signifier l'annulation de toutes les personnalisations en conflit avec les modifications du bot de base.
  3. Tentez de rebaser la version de l'extension.

Orientation d'une extension

Il est également possible de créer un clone d'une extension afin que vous puissiez travailler sur différentes branches en parallèle. Par exemple, vous pouvez effectuer cette opération lorsque vous disposez d'un bot étendu en production, mais que vous avez besoin d'une extension d'un autre nom pour travailler sur des modifications importantes.

Lorsque vous clonez une extension, le bot étendu est également traité comme une extension du bot d'origine, ce qui a les implications suivantes :

  • Au moment de la conception, les différents artefacts sont marqués comme hérités, locaux et personnalisés, comme dans les autres bots étendus.
  • Vous pouvez effectuer un rebasage sur les nouvelles versions du bot d'origine.
  • Les ID de suivi interne générés pour le clone de l'extension correspondent à ceux du bot d'origine.
Remarque

Le clonage fonctionne avec l'extension de bot uniquement si vous créez d'abord un bot étendu.

Cycle de vie après déploiement d'une brique étendue

Une fois que vous avez déployé une version étendue d'une brique, il est important d'établir une routine permettant d'intégrer des améliorations, puis de la redéployer.

Voici un exemple de ce à quoi pourrait ressembler une telle routine, en fonction des hypothèses suivantes :

  • Vous utilisez régulièrement les analyses pour améliorer la résolution des intentions dans la brique.
  • Vous ajoutez régulièrement de nouvelles fonctionnalités à la brique.
  • Vous disposez de deux instances de Digital Assistant (une pour la production et une pour le test et la préparation).
  1. Dans votre instance de production, créez une version de la brique déployée.

    Vous créez une nouvelle version de la brique dans votre instance de production afin de pouvoir capturer des données d'analyse à partir de l'utilisation réelle du client, puis utiliser le réentraînement pour compléter votre modèle d'entraînement avec des variations que la brique n'avait pas correctement comprises auparavant.

    Pour faciliter la lecture de cette procédure, supposons que la brique publiée est la version v1 et que la nouvelle version brouillon est la version 1.1.

  2. Evaluez les rapports d'analyse sur la brique et complétez les données d'entraînement de vos intentions avec des variations supplémentaires pour gérer une formulation utilisateur valide qui n'a pas été prise en compte dans vos données d'entraînement précédentes.

    Dans le cadre de ce processus, vous pouvez utiliser le réentraînement d'analyse pour ajouter des variations non résolues aux intentions appropriées.

  3. Exportez la brique (v1.1 dans l'exemple ci-dessus).
  4. Dans votre instance de test ou de préparation, importez la brique que vous venez d'exporter à partir de l'instance de production (v1.1).
  5. Dans l'instance de test ou de préparation, créez une nouvelle version de la brique importée. Cette nouvelle version permettra d'incorporer toutes les nouvelles fonctionnalités que vous ajoutez à la brique. (Cette version est appelée v2.)
  6. Dans v2, incorporez tous les ajouts ou modifications de fonctionnalité à inclure.

    Si vous avez développé ces modifications ailleurs, fusionnez-les manuellement dans v2.

  7. Entraînez et testez v2 jusqu'à ce que vous soyez satisfait des résultats.
  8. Exportez la brique (v2) à partir de votre instance de test.
  9. Dans votre instance de production, importez la brique que vous venez d'entraîner et de tester (v2).
  10. Former la brique.
  11. Publication de la brique.
  12. Si vous déployez la brique dans le cadre d'un assistant numérique, créez une nouvelle version de celui-ci.
  13. Mettez à jour la nouvelle version de l'assistant numérique afin d'utiliser la nouvelle version de la brique (v2).
  14. Mettez à jour le canal pour utiliser la nouvelle version de l'assistant numérique.
  15. Publiez la nouvelle version de l'assistant numérique.