Langues supplémentaires

Le développement d'assistants digitaux concerne le persona que vous avez conçu pour cela. Le persona définit le langage, le ton de la voix et l'attitude d'un assistant numérique.

Pour vous assurer que votre assistant numérique prend en charge le persona que vous avez conçu, vous devez garder le contrôle des messages sortants du bot pour chaque langue prise en charge. Les groupes de ressources représentent un emplacement unique où vous gérez les messages de bot, ce qui facilite la cohérence du ton de la voix. Pour la création d'assistants numériques prenant en charge une deuxième langue, il n'existe pas d'alternative réaliste aux groupes de ressources pour l'affichage des messages de bot.

Les chaînes de groupe de ressources sont créées de manière déclarative dans les briques et les assistants numériques Oracle Digital Assistant. Vous les référencez à partir de conversations, d'entités et de paramètres de configuration de brique à l'aide d'expressions FreeMarker Apache. Pour référencer une chaîne de message, vous utilisez une expression telle que la suivante :

${rb('message_key')}

rb référence la définition du groupe de ressources et recherche un identificateur de message portant le nom indiqué. Dans l'exemple ci-dessus, il recherche une clé de message portant le nom message_key.

Si aucun nom de clé de regroupement de ressources n'existe pour la langue de l'utilisateur, la chaîne définie pour la langue par défaut (la langue de base) est utilisée. Si une chaîne de message est manquante pour la langue par défaut, une exception est générée lors du test d'exécution.

Si vous devez transmettre des données à un message imprimé via un regroupement de ressources, vous pouvez le faire à l'aide de paramètres positionnels et nommés.

Paramètre positionnel : Hello {0}, {1}

Paramètre nommé : Hello {name}, {greeting}

Pour transmettre des valeurs que vous lisez à partir de variables ajoutées à une conversation, vous utilisez une expression comme celle présentée ci-dessous.

Pour les paramètres positionnels : ${rb('message_key',firstname.value, greetingMessage.value)}

Pour les paramètres nommés : ${rb('message_key','name,greeting',firstname.value, greetingMessage.value)}

Bien que les paramètres positionnels semblent plus simples à utiliser, nous vous recommandons d'utiliser des paramètres nommés lorsque vous le pouvez, car ils fournissent le contexte du type de données ajouté à un message. Connaître le contexte facilite la vie d'un traducteur.

L'utilisation complète des groupes de ressources dans votre brique implique d'y faire référence à partir des entités, du flux de dialogue et des paramètres de brique et d'assistant numérique. Pour faciliter la recherche des références de chaîne de groupes de ressources dans votre brique et votre assistant numérique, nous vous recommandons d'ajouter du contexte aux noms de clé de groupe de ressources en implémentant une convention de dénomination.

Par exemple, vous pouvez utiliser les noms suivants pour un message d'erreur, un message d'homonymie et des invites dans une entité de liste de valeurs :

• list.<entity_name>.errorMessage

• list.<entity_name>.disambiguationMessage

• list.<entity_name>.prompt1

• list.<entity_name>.prompt2

Pour une entité de conteneur composite, vous pouvez utiliser une structure de dénomination similaire, mais lui ajouter le nom de l'élément de conteneur :

• cbe.<entity_name>.<bag_item_name>.errorMessage

• cbe.<entity_name>.<bag_item_name>.disambiguationMessage

• cbe.<entity_name>.<bag_item_name>.prompt1

• cbe.<entity_name>.<bag_item_name>.prompt2

Si vous référencez une chaîne de regroupement de ressources à partir de l'invite d'un état de flux de dialogue ou si un état de flux de dialogue imprime simplement un message utilisateur, vous pouvez utiliser les éléments suivants :

• <dialog_flow_state_name>.prompt

• <dialog_flow_state_name>.message

Pour les éléments globaux, tels que les boutons de pagination ou d'aide d'un composant Common Response (Réponse commune), vous pouvez utiliser une convention de dénomination qui ne contient pas le nom d'un état de flux de dialogue spécifique :

• button.next

• button.previous

• button.cancel

• button.help

Il n'y a pas de règle stricte quant à savoir si vous utilisez la notation par points comme dans les exemples ci-dessus, les traits de soulignement ou quelque chose de votre propre.

Le composant Réponse commune vous permet de définir des mots-clés pour les points d'action afin que l'utilisateur puisse les "appuyer virtuellement" en envoyant le mot-clé sous forme de message. Les mots-clés sont particulièrement importants si l'interface utilisateur ne permet pas à l'utilisateur d'appuyer sur un bouton (par exemple, lors de l'utilisation de canaux de texte uniquement ou de voix).

Pour rappel, "soumettre" n'est pas appelé "soumettre" en allemand, portugais, français, arabe et toutes les autres langues que vous soutenez avec votre bot. Il est donc bon de savoir que la propriété keyword des éléments d'action du composant Réponse commune peut être lue à partir d'une clé de regroupement de ressources. Le message de regroupement de ressources est une liste de mots-clés séparés par des virgules que vous souhaitez utiliser.

Cet exemple de message de groupe de ressources s'attend à ce que l'argument region soit transmis lors du référencement du nom de clé du groupe de ressources. Dans l'exemple, les valeurs à gérer différemment sont définies comme region1 et region2. Vous pouvez définir ces valeurs comme vous le souhaitez, par exemple un code pays.

{region, select,
  region1 {message for region 1}
  region2 {message for region 2}
  other {message for all other regions}
}

Pour référencer le message dans le regroupement de ressources pour l'une des régions, vous devez utiliser l'expression suivante dans votre configuration de flux de dialogue, d'entité ou de brique :

${rb('the_key_name','region','<VARIABLE_CONTAINING_REGION_VALUE>.value')}

<VARIABLE_CONTAINING_REGION_VALUE> doit être remplacé par un nom de variable dans votre brique contenant la valeur pour laquelle un message différent est défini.