Voici les étapes initiales de configuration d'un assistant numérique avec prise en charge des langues natives :

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

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

     Pour la prise en charge des langues natives, vous devez définir cette valeur sur 20.12 ou une version ultérieure.

     Reportez-vous à Version de plate-forme.

   • Langue principale : détermine la langue par défaut de l'assistant numérique, et si l'assistant utilise la prise en charge native de cette langue ou s'appuie sur un service de traduction.

     Dans ce champ, vous devez sélectionner l'une des langues de la section Prise en charge native de la liste déroulante.

3. Si vous devez ajouter des langues supplémentaires à l'assistant numérique, procédez comme suit :
   1. Dans la navigation de gauche de l'assistant numérique qui vient d'être créé, cliquez sur .
   2. Cliquez sur Ajouter une langue et sélectionnez la langue à ajouter.

Dans les assistants numériques basés sur la prise en charge des langues natives d'Oracle Digital Assistant, les langues que vous configurez pour l'assistant numérique doivent correspondre aux langues configurées pour les briques.

Afin de vous aider à surveiller l'alignement entre les langues configurées pour vos briques et pour votre assistant numérique, une vérification est exécutée chaque fois que vous ajoutez une langue ou une brique à l'assistant numérique, et que chaque langue est marquée comme complète ou en cours :

• Les langues complètes sont celles dans lesquelles chacune des briques de l'assistant numérique est configurée.
• Les langues en cours sont les langues pour lesquelles certaines briques ne sont pas configurées.

Vous trouverez la liste des langues complètes et en cours dans l'onglet Général de la page Paramètres de l'assistant numérique ().

Si vous voulez tirer parti de la prise en charge des langues natives d'Oracle Digital Assistant dans un assistant numérique déjà configuré pour utiliser un service de traduction, procédez comme suit :

1. Pour toutes les briques de l'assistant numérique, créez des versions qui utilisent la prise en charge des langues natives.

   Reportez-vous à Création d'une brique avec des langues prises en charge de façon native.

   Pour obtenir la liste des langues prises en charge de façon native, reportez-vous à Langues prises en charge de façon native. (Si l'une des langues que vous comptez prendre en charge ne figure pas dans cette liste, vous devez continuer à utiliser le service de traduction.)

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

   1. Cliquez sur pour ouvrir le menu latéral et sélectionnez Développement > Assistants numériques.

   2. Dans la mosaïque de l'assistant numérique pour lequel vous souhaitez créer une version ou à cloner, cliquez sur et sélectionnez Version ou Cloner.

   3. Remplissez les champs requis et cliquez sur Créer.

3. Enlevez toutes les briques de la nouvelle version ou du clone que vous venez de créer.

   Cette opération est nécessaire car vous ne pouvez pas modifier l'assistant numérique afin qu'il utilise la prise en charge des langues natives s'il contient des briques recourant au service de traduction.

4. Créez une version ou un clone de cet assistant numérique modifié, sélectionnez la version de plate-forme 20.12 ou supérieure, puis sélectionnez le mode de prise en charge native des langues.

   Cette étape permet de conserver la configuration que vous avez effectuée pour l'assistant numérique, même si vous devez gérer les briques séparément.

5. Ajoutez les versions avec prise en charge des langues natives des briques à l'assistant numérique.

Dans les assistants numériques (ou les briques autonomes) qui utilisent plusieurs langues prises en charge de façon native, l'assistant numérique peut détecter automatiquement la langue de l'utilisateur au début de la session. Voici comment cela fonctionne :

• La langue est détectée automatiquement pour les assistants numériques et les briques configurés avec plusieurs langues prises en charge de façon native.
  • Si l'assistant numérique ne prend en charge qu'une seule langue (de façon native), 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 et non l'assistant numérique.
• La langue n'est pas détectée automatiquement si l'assistant numérique est accessible via un canal sur lequel la variable profile.languageTag ou profile.locale a été définie.
• La langue est détectée dans la première variation de la conversation et 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 expiration.

Voici les étapes initiales de configuration d'un assistant numérique monolingue dont la langue n'est pas l'anglais en mode Service de traduction :

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

2. 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 assistants numériques, 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 démarrez avec un nouvel assistant numérique, vous devez sélectionner la version la plus récente disponible, car la prise en charge de cette version sera la plus longue.

     Reportez-vous à Version de plate-forme.

   • Langue principale : ce champ apparaît uniquement si la version de plate-forme sélectionnée est 20.12 ou une version supérieure.

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

     Attention :

     Veillez à sélectionner une option dans la section Service de traduction. Si vous sélectionnez une option dans la section Prise en charge native, l'assistant numérique accepte uniquement les briques qui utilisent le mode Prise en charge 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 brique que vous ajoutez. Dans ce cas, cette langue est appelée langue prédominante au lieu de langue principale.

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

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

2. 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 assistants numériques, 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 démarrez avec un nouvel assistant numérique, vous devez sélectionner la version la plus récente disponible, car la prise en charge de cette version sera la plus longue.

     Reportez-vous à Version de plate-forme.

   • Langue principale : ce champ apparaît uniquement si la version de plate-forme sélectionnée est 20.12 ou une version supérieure.

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

     Attention :

     Veillez à sélectionner une option dans la section Service de traduction. Si vous sélectionnez une option dans la section Prise en charge native, l'assistant numérique accepte uniquement les briques qui utilisent le mode Prise en charge 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 brique que vous ajoutez. Dans ce cas, cette langue est appelée langue prédominante au lieu de langue principale.

1. Si vous ne l'avez pas encore fait, configurez un service de traduction pour votre instance Digital Assistant comme suit :
   1. Cliquez sur pour ouvrir le menu latéral et sélectionnez Paramètres > Service de traduction.
   2. Cliquez sur + Service.
   3. Entrez l'URL et le jeton d'autorisation du service Microsoft Translator ou de l'API Google Translation dans la boîte de dialogue Services de traduction.
   Reportez-vous à la documentation de Microsoft Translator et de l'API Google Translation pour découvrir comment obtenir l'URL et accéder au jeton.

   Remarque
   
   Pour utiliser l'API Google Translation, vous devez générer la clé d'API. Vous pouvez créer cette clé à partir de la console Google Cloud Platform (API et services > Informations d'identification). Pour en savoir plus, reportez-vous à la documentation Google Cloud Platform.
2. Définissez le service de traduction dans votre assistant numérique en procédant comme suit :
   1. Cliquez sur pour ouvrir le menu latéral, sélectionnez Développement > Assistants numériques, puis sélectionnez l'assistant numérique.
   2. Dans la barre de navigation de gauche de l'assistant numérique, cliquez sur l'icône Paramètres () et sélectionnez l'onglet Général.
   3. Accédez à la liste déroulante Service de traduction et sélectionnez le service de traduction.

Par défaut, si un assistant numérique est configuré avec un service de traduction, l'assistant détecte la langue de l'utilisateur de la même manière qu'une brique avec le composant Détecter la langue.

Cependant, vous devez également vous assurer que les briques de l'assistant numérique utilisent la langue détectée par ce dernier. Lorsqu'une brique fait partie d'un assistant numérique, celui-ci traduit l'entrée utilisateur en anglais et transmet ce texte traduit à la brique. Par défaut, le composant Détecter la langue de la brique détecte ainsi l'anglais comme langue et définit la variable profile.LanguageTag sur l'anglais, même si l'utilisateur ne saisit pas de texte en anglais.

Pour empêcher ce basculement vers l'anglais dans une brique avec un flux de dialogue développé en mode visuel, vous devez définir la propriété Balise de langue de profil existante du composant Détecter la langue sur True dans chaque brique.

Vous veillez ainsi à ce que la brique respecte la valeur de la variable profile.LanguageTag définie par l'assistant numérique.

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

      useExistingProfileLanguageTag: true

Voici un exemple de composant System.DetectLanguage d'une brique basée sur YAML avec useExistingProfileLanguageTag défini :

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

Dans un assistant numérique qui utilise un service de traduction, vous pouvez adopter l'une des deux approches suivantes :

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

  Si vous optez pour cette approche, il vous suffit de disposer de vos messages de sortie en anglais. Aucune autre configuration n'est requise. Le service de traduction que vous avez configuré traduit automatiquement les messages de sortie dans la langue de l'utilisateur.

• Utilisez un groupe de ressources pour traduire vous-même les messages de sortie.
  Remarque
  
  Pour les messages de sortie sans référence à une clé de groupe de ressources, le service de traduction est automatiquement utilisé pour traduire les messages.

Dans les assistants numériques qui utilisent un service de traduction, l'assistant reconnaît l'appel explicite de briques dans la langue détectée et en anglais.

Vous pouvez trouver les chaînes traduisibles aux deux emplacements suivants :

• Sur la page Briques () de l'assistant numérique

  Vous trouverez ici les chaînes qui sont principalement utilisées pour les cartes d'aide affichées lorsqu'un utilisateur demande de l'aide dans l'assistant numérique et lorsque l'assistant numérique salue et accueille l'utilisateur.

  Les éléments suivants sont traduisibles pour chaque brique :

  • Champs Phrase de description, Description et Appel
  • Exemples de variation
• Sur la page Paramètres (), dans l'onglet Configurations, dans la section Paramètres de conversation A partir de la version 21.04 de la plate-forme, des entrées de groupe de ressources sont automatiquement créées pour ces paramètres.

Les clés de groupe de ressources permettent d'identifier le texte de sortie à traduire, et de fournir des valeurs dans différentes 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 sur la version 21.02 ou antérieure de la plate-forme), vous devez créer les clés manuellement.

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

1. Dans la barre de navigation de gauche de l'assistant numérique, cliquez sur
2. Sélectionnez une brique.
3. Mettez à jour les champs Phrase de description, Description et Appel avec les références aux groupes de ressources au format suivant :

   ${rb.BundleKeyName}

   Par exemple, vous pouvez utiliser ce qui suit afin de faire référence à une clé pour la ligne de description d'une brique de commande de pizza.

   ${rb.PizzaSkillShortDescription}

4. Dans la section Exemples de la page, positionnez le curseur sur un exemple, cliquez sur son icône Modifier et remplacez le texte par une référence à une clé de groupe de ressources comme ci-dessus.
5. Répétez l'étape précédente pour les autres exemples de variation de la brique.
6. Répétez les quatre étapes précédentes pour chaque brique.

Les assistants numériques possèdent un certain nombre de propriétés de configuration qui sont utilisées pour afficher des invites et messages divers.

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

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

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

   Par exemple, si vous disposez d'une clé dans le groupe de ressources portant le nom daAcknowledgementResponse pour la propriété Acknowledgement Response, saisissez les informations suivantes dans le champ Réponse d'accusé de réception :

   ${rb('daAcknowledgementResponse')}

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

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

Vous pouvez conserver les références aux variables 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é de groupe de ressources correspondante, insérez {0}, {1}, etc. comme codes de substitution pour chaque variable système. Par exemple, dans l'entrée anglaise (ou par défaut) que vous créez pour la propriété Exit Flow Confirmation, vous pouvez utiliser le texte suivant :

   Exited {0} in {1}.

2. Ensuite, dans la valeur de la propriété, entrez la référence à la clé de groupe au format suivant :

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

   Par exemple, voici ce que vous pourriez obtenir pour la propriété Exit Flow Confirmation (daExitFlowConfirmation étant la clé de groupe correspondante) :

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

Vous pouvez exporter et importer des groupes de ressources sous forme de fichier CSV, ce qui vous permet de travailler sur les groupes hors ligne.

Le fichier CSV doit comporter les colonnes suivantes :

• languageTag
• key
• message
• annotation

Pour exporter un fichier CSV avec le groupe de ressources existant, procédez comme suit :

• Sur la page Groupe de ressources pour votre brique ou votre 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és au groupe de ressources, un fichier avec le format CSV requis est exporté.

Pour importer un fichier de groupe de ressources, procédez comme suit :

• Sur la page Groupe de ressources pour votre brique ou votre assistant numérique, cliquez sur .

A partir de la version 21.04 de la plate-forme, des entrées de regroupement de ressources sont automatiquement créées 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 générer ces entrées pour vous.

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

Si vous souhaitez utiliser des entrées de groupe 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 la liste des propriétés de personnalisation que vous pouvez traduire avec les noms suggérés pour les clés de groupe et les expressions que vous utiliseriez pour référencer ces clés de groupe à partir des champs pour les propriétés.