Dialogflow accepte de nombreuses langues. Pour obtenir la liste complète, consultez la page de référence des langues. La langue que vous choisissez lors de la création d'un agent est définie comme langue par défaut, mais d'autres langues peuvent être ajoutées.
Langues racine et variantes locales
Il existe deux catégories de langues :
- les langues racine : langues telles que l'anglais (en) sans spécification de variante locale ;
- les langues avec variantes locales : par exemple, l'anglais des États-Unis (en-US), qui spécifient une variante linguistique selon le pays ou la région.
Certaines langues sont à la fois des langues racines et des variantes locales. Il existe des différences significatives au niveau des paramètres régionaux pour ces langues, de sorte que ces paramètres régionaux ne peuvent pas avoir une langue racine commune. Exemples :
- Chinois cantonais (zh-HK)
- Chinois simplifié (zh-CN)
- Chinois traditionnel (zh-TW)
- Portugais du Brésil (pt-BR)
- Portugais du Portugal (pt)
Vous devez d'abord concevoir votre agent pour les langues racine, et ne personnaliser les paramètres de variantes locales que si nécessaire.
Ajouter une langue
Pour ajouter une langue ou une variante locale à l'aide de la console Dialogflow CX :
- Ouvrez la console Dialogflow CX.
- Choisissez le projet Google Cloud pour l'agent.
- Recherchez l'agent dans la liste.
- Cliquez sur le nom à afficher de l'agent.
- Cliquez sur Agent Settings (Paramètres de l'agent).
- Cliquez sur l'onglet Langues.
- Ajoutez ou supprimez des langues si nécessaire.
- Cliquez sur Enregistrer.
Données spécifiques à une langue
La plupart des données d'agent sont communes à toutes les langues d'un agent multilingue. Cependant, le texte utilisé pour interagir avec un utilisateur final est spécifique à une langue. Lorsque vous créez un agent multilingue, vous devez fournir ces données spécifiques à chaque langue. Lorsque vous sélectionnez une langue dans la console ou fournissez une langue à l'API, vous pouvez accéder à ces données spécifiques pour la langue indiquée. Vous trouverez ci-dessous la liste complète des données spécifiques à une langue :
Pour accéder aux données spécifiques à une langue en utilisant la console, cliquez sur le bouton de langue situé en haut de la console.
Par exemple, l'entité size (taille) ci-dessous est utilisée pour des commandes de t-shirts. L'agent a été configuré initialement en anglais. Par conséquent, l'entité possède des entrées telles que "S" avec le synonyme "small" (petit). Lorsque l'espagnol est ajouté en tant que langue, l'entité est créée par Dialogflow pour prendre en compte la nouvelle langue, mais vous devez fournir les entrées d'entité en espagnol.
| Entité | Synonymes |
|---|---|
| XS | XS, extra pequeño |
| S | S, pequeño |
| M | M, medio |
| L | L, grande |
| XL | XL, extra grande |
Générer des données spécifiques à une langue avec l'IA
Les agents conversationnels (Dialogflow CX) vous permettent d'accélérer l'ajout de données spécifiques à une langue en utilisant la génération par IA pour fournir les données à votre place, au lieu de les saisir manuellement. Vous pouvez le faire au niveau de l'intention, de l'entité et de l'exécution en tant que fonctionnalité d'aperçu.
Si vous choisissez de ne pas utiliser la génération par IA, vous pouvez toujours saisir manuellement les données pour les langues autres que celle par défaut.
Génération d'intentions par l'IA
Générez automatiquement des expressions d'entraînement dans une langue autre que celle par défaut :
- Accédez à Paramètres de l'agent > Langues et assurez-vous qu'une ou plusieurs langues autres que celle par défaut sont activées pour votre agent.
- Accédez au menu déroulant des langues en haut de la console et sélectionnez la langue de votre choix (autre que celle par défaut).
- Accédez à l'onglet Gérer, puis cliquez sur Intents et sélectionnez l'un de vos intents. Assurez-vous que le champ Description contient une description de l'objectif de l'intention. La description peut être dans votre langue par défaut ou dans la langue que vous consultez.
- Lorsque vous activez une langue autre que celle par défaut, les agents conversationnels (Dialogflow CX) ne traduisent pas les expressions d'entraînement existantes dans la nouvelle langue. Pour créer des expressions d'entraînement dans la nouvelle langue, cliquez sur le bouton radio __ nouvelles expressions générées par le LLM. La valeur par défaut est "3". Pour copier et traduire automatiquement vos expressions d'entraînement existantes, sélectionnez Toutes les expressions d'entraînement de votre langue par défaut traduites par génération d'IA.
- Cliquez sur + Ajouter. Le nombre de phrases d'entraînement que vous avez spécifié est généré et ajouté au tableau dans la langue que vous avez sélectionnée. Veillez à vérifier l'exactitude de toutes les expressions d'entraînement générées.
(Aperçu) Génération d'IA pour les entités
Générez et traduisez automatiquement des valeurs de référence et des synonymes dans une langue autre que celle par défaut :
- Accédez à Paramètres de l'agent > Langues et assurez-vous qu'une ou plusieurs langues autres que celle par défaut sont activées pour votre agent.
- Accédez au menu déroulant des langues en haut de la console et sélectionnez la langue autre que celle par défaut de votre choix.
- Accédez à l'onglet Gérer, puis cliquez sur Types d'entités et sélectionnez l'un de vos types d'entités.
- Lorsque vous activez une langue autre que celle par défaut, les agents conversationnels (Dialogflow CX) ne traduisent pas automatiquement les valeurs de référence et les synonymes existants. Pour traduire automatiquement ces valeurs dans la nouvelle langue, cliquez sur + Copier depuis la langue par défaut. Toutes les données d'origine du type d'entité de la langue par défaut seront traduites dans la nouvelle langue et insérées dans le tableau. Sachez que la traduction de plus de 50 éléments à la fois peut entraîner des erreurs. Chaque valeur de référence et chaque synonyme sont comptabilisés comme un élément.
- Vous pouvez également ajouter des valeurs de référence en cliquant sur + Ajouter une entrée. Vous pouvez saisir une valeur de référence dans votre langue par défaut. La valeur de référence et ses synonymes seront automatiquement traduits dans la nouvelle langue.
(Aperçu) Génération de l'IA pour le traitement
La génération par IA est disponible pour les types de traitement de route, de groupes de routes et de gestionnaires d'événements. Pour en savoir plus sur ces types de routes, consultez la documentation sur les routes et les gestionnaires d'événements.
Cette fonctionnalité ne s'affiche que si vous consultez l'agent dans une langue autre que celle par défaut et dans l'un des types de routes spécifiés. Accédez à la section Fulfillment de l'itinéraire. Pour copier et traduire automatiquement les réponses de l'agent de votre langue par défaut dans la langue que vous consultez, cliquez sur Copier et traduire. Sachez que la traduction de plus de 50 réponses à la fois peut entraîner des erreurs.
Données spécifiques à une langue lorsque vous utilisez l'API
Pour accéder aux données spécifiques à une langue avec l'API, fournissez le paramètre languageCode lors de l'obtention, de la création ou de la mise à jour des types EntityType, Intent ou Page.
Sélectionnez un protocole et une version pour la référence EntityType :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource EntityType | Ressource EntityType |
| RPC | Interface EntityType | Interface EntityType |
| C++ | EntityTypesClient | Non disponible |
| C# | EntityTypesClient | Non disponible |
| Go | EntityTypesClient | Non disponible |
| Java | EntityTypesClient | EntityTypesClient |
| Node.js | EntityTypesClient | EntityTypesClient |
| PHP | Non disponible | Non disponible |
| Python | EntityTypesClient | EntityTypesClient |
| Ruby | Non disponible | Non disponible |
Sélectionnez un protocole et une version pour la référence de l'intent :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource d'intent | Ressource d'intent |
| RPC | Interface de l'intent | Interface de l'intent |
| C++ | IntentsClient | Non disponible |
| C# | IntentsClient | Non disponible |
| Go | IntentsClient | Non disponible |
| Java | IntentsClient | IntentsClient |
| Node.js | IntentsClient | IntentsClient |
| PHP | Non disponible | Non disponible |
| Python | IntentsClient | IntentsClient |
| Ruby | Non disponible | Non disponible |
Sélectionnez un protocole et une version pour la référence de la page :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource de la page | Ressource de la page |
| RPC | Interface de la page | Interface de la page |
| C++ | PagesClient | Non disponible |
| C# | PagesClient | Non disponible |
| Go | PagesClient | Non disponible |
| Java | PagesClient | PagesClient |
| Node.js | PagesClient | PagesClient |
| PHP | Non disponible | Non disponible |
| Python | PagesClient | PagesClient |
| Ruby | Non disponible | Non disponible |
Vous devez effectuer des appels d'API distincts pour chaque langue afin d'accéder à toutes les données spécifiques à une langue. Si vos appels d'API mettent à jour des données génériques, ces données sont mises à jour pour toutes les langues.
Tester dans le simulateur
Si vous utilisez le simulateur, sélectionnez la langue que vous souhaitez utiliser sous le nom de l'agent.
Fournir une langue à l'aide de l'API
Lors de l'envoi de requêtes en utilisant l'API, définissez le champ queryInput.languageCode de la méthode detectIntent.
Pour en savoir plus, reportez-vous au type Sessions.
Sélectionnez un protocole et une version pour la référence de session :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource de session | Ressource de session |
| RPC | Interface de session | Interface de session |
| C++ | SessionsClient | Non disponible |
| C# | SessionsClient | Non disponible |
| Go | SessionsClient | Non disponible |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | Non disponible | Non disponible |
| Python | SessionsClient | SessionsClient |
| Ruby | Non disponible | Non disponible |
Détection automatique de la langue
Si la langue de la requête de l'utilisateur final diffère de celle spécifiée dans la requête, Dialogflow peut la détecter et passer automatiquement à la langue de l'utilisateur final. Consultez la page Référence des langues pour obtenir la liste des langues disponibles pour cette fonctionnalité. Le champ LanguageInfo d'un WebhookRequest identifie la langue d'entrée, la langue résolue et le score de confiance lorsque la détection de la langue est activée.
Activer la détection automatique de la langue
Vous devez activer la détection automatique de la langue au niveau de l'agent et du flux.
Accédez aux paramètres de l'agent, puis sélectionnez l'onglet Langues.
Cochez la case Activer la détection et le changement automatiques de langue pour activer cette fonctionnalité pour l'agent. Cliquez sur Enregistrer pour enregistrer les modifications.
Sélectionnez un flux, puis accédez à Paramètres du flux. Dans le panneau des paramètres du flux, cochez la case Activer la détection et le changement automatiques de langue.
Dans le menu déroulant Langues, sélectionnez les langues dans lesquelles vous souhaitez que Dialogflow puisse répondre. Assurez-vous de ne sélectionner que les langues compatibles avec la fonctionnalité de détection automatique de la langue.
Cliquez sur Enregistrer pour enregistrer les modifications.
Requêtes qui ne spécifient pas de langue pour l'agent
Lorsque Dialogflow reçoit une requête qui ne fournit pas de langue compatible avec l'agent, les règles suivantes s'appliquent :
- Si la requête ne fournit pas de langue, Dialogflow détermine automatiquement la langue d'entrée et répond dans cette langue si la détection automatique de la langue est activée. Si la détection automatique de la langue est désactivée, Dialogflow traite la requête dans la langue par défaut.
- Si la requête fournit une variante locale non compatible avec l'agent, mais que la langue racine associée est acceptée par l'agent, Dialogflow traite la requête dans la langue racine.
- L'extraction d'entité système est une exception à la règle précédente. L'extraction d'entité système utilise la variante de langue fournie, même si celle-ci n'est pas compatible avec l'agent.
Intégrations
Les interactions d'agent via des intégrations textuelles n'utilisent que la langue par défaut de l'agent.