Voici les étapes initiales de la configuration d'un assistant numérique avec la prise en charge linguistique native :

1. Cliquez sur pour ouvrir le menu latéral, sélectionnez Development > Digital Assistants (Développement > Assistants numériques), puis cliquez sur New Digital Assistant (Nouvel assistant numérique).

2. 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 assistants numériques, 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.

     Pour la prise en charge linguistique native, vous devez régler cette valeur à 20.12 ou supérieure.

     Voir Version de plate-forme.

   • Langue principale : Cela détermine à la fois la langue par défaut de l'assistant numérique et si elle sera prise en charge de manière native ou par l'intermédiaire d'un service de traduction.

     Dans ce champ, vous devez sélectionner l'une des langues dans la section Natively-Supported (Prise en charge de manière native) de la liste déroulante.

3. Si vous avez besoin d'ajouter des langues supplémentaires à l'assistant numérique :
   1. Dans la barre de navigation gauche du tout nouvel assistant numérique, cliquez sur .
   2. Cliquez sur Add Language (Ajouter une langue) et sélectionnez la langue à ajouter.

Dans les assistants numériques basés sur la prise en charge linguistique native d'Oracle Digital Assistant, les langues que vous configurez pour eux doivent correspondre à celles configurées pour les compétences.

Pour vous aider à vérifier si les langues configurées pour vos compétences et votre assistant numérique correspondent, une vérification est exécutée chaque fois que vous ajoutez une langue ou une compétence à l'assistant numérique et que chaque langue est marquée Complete (Complète) ou In Progress (En cours) :

• Les langues complètes sont celles dans lesquelles chacune des compétences de l'assistant numérique est configurée pour cette langue.
• Les langues en cours sont celles pour lesquelles une ou plusieurs compétences ne sont pas configurées.

Vous pouvez trouver la liste des langues complètes et en cours dans l'onglet General de la page Settings (Paramètres) de l'assistant numérique ().

Si vous souhaitez tirer profit de la prise en charge linguistique native d'Oracle Digital Assistant dans un assistant numérique qui a déjà été configuré pour utiliser un service de traduction, suivez les étapes générales ci-dessous :

1. Pour toutes les compétences de l'assistant numérique, créez des versions qui utilisent la prise en charge linguistique native.

   Voir Créer une compétence avec des langues prises en charge de manière native.

   Pour la liste des langues prises en charge de manière native, voir Langues prises en charge de manière native. (Si l'une des langues que vous souhaitez prendre en charge ne figure pas sur cette liste, vous devez continuer à utiliser le mode de service de traduction.)

2. Créez une nouvelle version ou un clone de l'assistant numérique.

   1. Cliquez sur pour ouvrir le menu latéral, puis sur Development > Digital Assistants (Développement > Assistants numériques).

   2. Dans la vignette de l'assistant numérique que vous souhaitez modifier ou cloner, cliquez sur et sélectionnez Version ou Clone.

   3. Remplissez les champs obligatoires et cliquez sur Create (Créer).

3. Supprimez toutes les compétences de la nouvelle version ou du clone que vous venez de créer.

   Ceci est nécessaire, car vous ne pouvez pas modifier l'assistant numérique pour qu'il utilise la prise en charge linguistique native s'il contient des compétences en mode de service de traduction.

4. Créez une nouvelle version ou un clone de cet assistant numérique modifié, sélectionnez la version de plate-forme 20.12 ou supérieure, puis le mode linguistique Natively-Supported (Prise en charge de manière native).

   Avec cette étape, vous êtes en mesure de préserver la configuration que vous avez effectuée pour l'assistant numérique, même si vous devez traiter les compétences séparément.

5. Ajoutez les versions avec prise en charge linguistique native des compétences à l'assistant numérique.

Dans les assistants numériques (ou compétences autonomes) qui utilisent plusieurs langues prises en charge de manière native, l'assistant numérique peut détecter automatiquement la langue de l'utilisateur au début de la session. Fonctionnement :

• La langue est automatiquement détectée pour les assistants numériques et les compétences configurés avec plusieurs langues prises en charge de manière native.
  • S'il n'y a qu'une seule langue (prise en charge de manière native) dans l'assistant numérique, la détection de la langue est désactivée.
  • Si l'assistant numérique utilise un service de traduction, ce dernier gère la détection de la langue à sa place.
• La langue n'est pas détectée automatiquement si l'assistant numérique est accessible par un canal où la variable profile.languageTag ou profile.locale a été définie.
• La langue est détectée dans le premier énoncé de la conversation. Elle n'est pas mise à jour dans la session, même si l'utilisateur change de langue.
• Par défaut, la session de canal dure 7 jours avant son expiration.

Voici les étapes initiales de la configuration d'un assistant numérique en mode de service de traduction :

1. Cliquez sur pour ouvrir le menu latéral, sélectionnez Development > Digital Assistants (Développement > Assistants numériques), puis cliquez sur New Digital Assistant (Nouvel assistant numérique).

2. 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 assistants numériques, 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 vous commencez par un nouvel assistant numérique, vous devez sélectionner la version la plus récente disponible, car la prise en charge de cette version durera le plus longtemps.

     Voir Version de plate-forme.

   • Primary Language (Langue principale) : Ce champ ne s'affiche que si vous avez sélectionné la version 20.12 ou supérieure de la plate-forme.

     Dans ce champ, vous devez sélectionner votre langue cible dans la section Translation Service (Service de traduction) de la liste déroulante.

     Attention :

     Assurez-vous d'avoir effectué votre sélection dans la section Translation Service (Service de traduction). Si vous sélectionnez dans la section Natively-Supported (Prise en charge de manière native), l'assistant numérique n'acceptera que les compétences qui utilisent le mode Natively-Supported (Prise en charge de manière native).

     Si ce champ n'apparaît pas, la langue de l'assistant numérique est déterminée par la langue de la première compétence que vous lui ajoutez. Dans ce cas, cette langue est appelée langue prédominante au lieu de langue principale.

Voici les étapes initiales de la configuration d'un assistant numérique multilingue en mode linguistique de service de traduction :

1. Cliquez sur pour ouvrir le menu latéral, sélectionnez Development > Digital Assistants (Développement > Assistants numériques), puis cliquez sur New Digital Assistant (Nouvel assistant numérique).

2. 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 assistants numériques, 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 vous commencez par un nouvel assistant numérique, vous devez sélectionner la version la plus récente disponible, car la prise en charge de cette version durera le plus longtemps.

     Voir Version de plate-forme.

   • Primary Language (Langue principale) : Ce champ ne s'affiche que si vous avez sélectionné la version 20.12 ou supérieure de la plate-forme.

     Dans ce champ, vous devez sélectionner English (Anglais) dans la section Translation Service (Service de traduction) de la liste déroulante.

     Attention :

     Assurez-vous d'avoir effectué votre sélection dans la section Translation Service (Service de traduction). Si vous sélectionnez dans la section Natively-Supported (Prise en charge de manière native), l'assistant numérique n'acceptera que les compétences qui utilisent le mode Natively-Supported (Prise en charge de manière native).

     Si ce champ n'apparaît pas, la langue de l'assistant numérique est déterminée par la langue de la première compétence que vous lui ajoutez. Dans ce cas, cette langue est appelée langue prédominante au lieu de langue principale.

1. Si ce n'est pas encore fait, configurez un service de traduction pour votre instance de Digital Assistant. Procédez de la façon suivante :
   1. Cliquez sur pour ouvrir le menu latéral et sélectionnez Settings > Translation Service (Paramètres > Service de traduction).
   2. Cliquez sur + Service.
   3. Entrez l'URL et le jeton d'autorisation pour le service de traduction de Microsoft ou Google dans la boîte de dialogue Translation Services (Services de traduction).
   Consultez la documentation de Microsoft Translator et de l'API de traduction Google pour voir comment obtenir l'URL et le jeton d'accès.

   Note
   
   Pour utiliser l'API de traduction Google, vous devez générer la clé d'API. Vous créez cette clé depuis la console GCP (APIs & services > Credentials (API et services > Données d'identification)). Pour en savoir plus, voir la documentation de la plate-forme Google Cloud.
2. Définissez le service de traduction dans votre assistant numérique en procédant de la façon suivante :
   1. Cliquez sur pour ouvrir le menu latéral, sélectionnez Development > Digital Assistants (Développement > Assistants numériques), puis votre assistant.
   2. Dans la barre de navigation gauche de l'assistant numérique, cliquez sur l'icône Settings (Paramètres) () et sélectionnez l'onglet General (Général).
   3. Naviguez jusqu'à la liste déroulante Translation Service (Service de traduction) et effectuez votre sélection.

Par défaut, si un assistant numérique est configuré avec un service de traduction, il détecte la langue de l'utilisateur comme le fait une compétence dotée du composant Detect Language (Détecter la langue).

Cependant, vous devez également vous assurer que les compétences de l'assistant numérique utilisent la langue détectée par l'assistant numérique. Lorsqu'une compétence fait partie d'un assistant numérique, ce dernier traduit l'entrée de l'utilisateur en anglais et transmet ce texte à la compétence. Par défaut, le composant Détecter la langue de la compétence détecterait donc l'anglais et réglerait la variable profile.LanguageTag à anglais, même si l'utilisateur a entré du texte dans une autre langue.

Pour empêcher ce passage à l'anglais dans une compétence avec un flux de dialogue développé en mode visuel, vous devez régler la propriété Existing Profile Language Tag (Marqueur de langue de profil existant) du composant Détecter la langue à True dans chaque compétence.

La compétence honorera ainsi la valeur de la variable profile.LanguageTag définie par l'assistant numérique.

Pour empêcher ce retour à l'anglais dans une compétence basée sur YAML, vous devez ajouter la propriété suivante au composant System.DetectLanguage dans chaque compétence :

      useExistingProfileLanguageTag: true

Voici un exemple du composant System.DetectLanguage d'une compétence basée sur YAML où useExistingProfileLanguageTag est défini :

  detectLang:
    component: "System.DetectLanguage"
    properties:
      useExistingProfileLanguageTag: true
    transitions:
      ...

Pour un texte visible par l'utilisateur dans un assistant numérique qui utilise un service de traduction, vous pouvez utiliser l'une ou l'autre de ces approches :

• Utilisez le service de traduction configuré pour l'assistant numérique.

  Si vous utilisez cette approche, vous n'avez besoin que de messages de sortie en anglais. Aucune autre configuration n'est nécessaire. Le service de traduction configuré traduira automatiquement les messages de sortie dans la langue de l'utilisateur.

• Utilisez un ensemble de ressources pour traduire les messages de sortie vous-même.
  Note
  
  Pour les messages de sortie sans référence à une clé d'ensemble de ressources, le service de traduction sera automatiquement utilisé pour les traduire.

Dans les assistants numériques utilisant un service de traduction, un appel explicite des compétences est reconnu dans la langue détectée et en anglais.

Les chaînes traduisibles figurent aux deux endroits suivants :

• Dans la page Compétences () de l'assistant numérique.

  Vous y trouverez les chaînes principalement utilisées pour les cartes d'aide affichées lorsqu'un utilisateur demande de l'aide dans l'assistant numérique et que ce dernier l'accueille.

  Pour chaque compétence, vous pouvez traduire

  • Les champs One-sentence Description (Description en une phrase), Description, et Invocation (Appel).
  • Les exemples d'énoncés.
• Dans la page Settings (Paramètres) (), onglet Configurations, section Conversation Parameters (Paramètres de conversation). À partir de la version 21.04 de la plate-forme, des entrées d'ensemble de ressources sont automatiquement créées pour ces paramètres.

Les clés d'ensemble de ressources sont utilisées pour identifier le texte de sortie qui doit être traduit et fournir des valeurs dans une ou plusieurs langues. Pour les assistants numériques qui utilisent la version 21.04 ou ultérieure de la plate-forme, les clés sont générées automatiquement pour les paramètres de configuration de l'assistant numérique. Pour les autres chaînes (et pour les paramètres de configuration des assistants numériques qui utilisent les versions 21.02 ou antérieures de la plate-forme), vous devez créer manuellement des clés.

Lorsqu'un assistant numérique accueille l'utilisateur ou présente des informations d'aide pour les compétences qu'il contient, il utilise les valeurs de la page Compétences de l'assistant numérique pour alimenter les cartes d'accueil et d'aide. Vous pouvez traduire les informations qui apparaissent sur ces cartes d'aide en modifiant certains champs de la page Compétences.

1. Dans la barre de navigation gauche de l'assistant numérique, cliquez sur
2. Sélectionnez une compétence.
3. Mettez à jour les champs One-sentence Description (Description en une phrase), Description, et Invocation (Appel) en indiquant des références aux ensembles de ressources sous la forme suivante :

   ${rb.BundleKeyName}

   Par exemple, vous pouvez utiliser ce qui suit pour référencer une clé pour la description en une ligne d'une compétence de commande de pizza.

   ${rb.PizzaSkillShortDescription}

4. Dans la section Examples (Exemples) de la page, positionnez le curseur sur un exemple, cliquez sur l'icône Edit (Modifier) correspondante et remplacez le texte par une référence à une clé d'ensemble de ressources comme ci-dessus.
5. Répétez l'étape précédente pour les autres exemples d'énoncés de la compétence.
6. Répétez les quatre étapes précédentes pour chaque compétence.

Les assistants numériques disposent d'un certain nombre de propriétés de configuration permettant d'afficher divers messages et invites.

Pour définir la sortie d'une propriété de configuration, vous référencez la clé de variable et de message d'ensemble de ressources. Par exemple : ${rb('WhatType')}. Vous pouvez également utiliser la notation par points, par exemple : ${rb.WhatType}

1. Dans la barre de navigation gauche de l'assistant numérique, cliquez sur l'icône Settings (Paramètres) () et sélectionnez l'onglet Configurations.

2. Pour les propriétés de la section Conversation Parameters (Paramètres de conversation) de la page, entrez les références aux clés d'ensembles de ressources que vous avez définies pour chacune d'elles.

   Par exemple, si vous avez une clé dans votre ensemble de ressources appelée daAcknowledgementResponse pour la propriété Acknowledgement Response (Réponse d'accusé de réception), vous entrez ce qui suit dans le champ Acknowledgement Response :

   ${rb('daAcknowledgementResponse')}

Vous pouvez également utiliser des paramètres dans les valeurs pour des clés d'ensemble, ce qui vous permet d'utiliser des variables de système dans la sortie. Par exemple, la valeur par défaut de la propriété Exit Flow Confirmation (Confirmation de sortie du flux) est :

Exited ${system.routingFromIntent} in ${system.routingFromSkill}.

Vous pouvez conserver les références aux variables de système (dans ce cas, system.routingFromIntent et system.routingFromSkill) dans vos réponses traduites en procédant comme suit :

1. Dans la valeur de la clé d'ensemble de ressources correspondante, insérez {0}, {1}, etc. comme codes de substitution pour chaque variable de système. Par exemple, dans l'entrée en anglais (ou par défaut) que vous créez pour la propriété Exit Flow Confirmation (Confirmation de sortie du flux), vous pouvez utiliser le texte suivant :

   Exited {0} in {1}.

2. Puis, dans la valeur de la propriété, entrez la référence à la clé d'ensemble dans le format suivant :

   ${rb('bundleKey', '${systemVariableForParam0}', '${systemVariableForParam1}')}

   Par exemple, elle aurait l'aspect suivant pour la propriété Exit Flow Confirmation (où daExitFlowConfirmation indique la clé d'ensemble correspondante) :

   ${rb('daExitFlowConfirmation', '${system.routingFromIntent}', '${system.routingFromSkill}')}

Vous pouvez exporter et importer des ensembles de ressources dans un fichier CSV, ce qui vous permet de travailler sur les ensembles hors ligne.

Le fichier CSV doit comporter les colonnes suivantes :

• languageTag
• key
• message
• annotation

Pour exporter un fichier CSV avec l'ensemble de ressources existant :

• Dans la page Ensemble de ressources pour votre compétence ou assistant numérique, cliquez sur pour exporter un fichier CSV avec le groupe de ressources existant.

  Même si vous n'avez pas encore ajouté de clé à l'ensemble de ressources, un fichier dans le format CSV requis sera exporté.

Pour importer un fichier d'ensemble de ressources :

• Dans la page Ensemble de ressources pour votre compétence ou assistant numérique, cliquez sur .

À partir de la version 21.04 de la plate-forme, des entrées d'ensemble de ressources sont créées automatiquement pour les paramètres de configuration de l'assistant numérique. Si votre assistant numérique est basé sur la version de plate-forme 21.02 ou antérieure, vous pouvez effectuer une mise à niveau vers la version 21.04 ou supérieure pour que ces entrées soient générées pour vous.

Voici la liste de toutes les entrées d'ensemble de ressources système pour les assistants numériques ainsi que leurs valeurs par défaut.

Si vous souhaitez utiliser des entrées d'ensemble de ressources pour vos paramètres de configuration sans mettre à niveau la version de plate-forme de l'assistant numérique vers la version 21.04 ou supérieure, voici une liste des propriétés de personnalisation que vous pouvez traduire, ainsi que les noms suggérés pour les clés d'ensemble et les expressions à utiliser pour référencer ces clés à partir des champs pour les propriétés.