Localiser le contenu des Cartes adaptatives

En utilisant les Cartes adaptatives, vous pouvez présenter des informations riches et structurées aux utilisateurs des assistants de Copilot Studio. Pour les assistants multilingues, assurez-vous de localiser entièrement à la fois le contenu de votre sujet et le texte de la carte adaptative. Avec les cartes adaptatives, vous pouvez concevoir et intégrer une interface utilisateur légère pour toutes les principales plateformes et infrastructures.

Copilot Studio prend en charge la localisation du texte statique dans les Cartes adaptatives via les mêmes fichiers de localisation JSON/ResX que vous utilisez déjà pour les rubriques.

Cet article explique le processus de localisation, comment traduire le texte de la carte adaptative, et comment gérer le contenu mixte contenant à la fois des valeurs statiques et dynamiques.

Avant de commencer

Vous devez connaître les concepts suivants :

Comprendre les workflows de localisation

Copilot Studio inclut tout le texte statique de la carte adaptative dans vos fichiers de localisation exportés. Ce texte comprend :

  • Valeurs TextBlock
  • Titres des boutons
  • Texte d’espace réservé
  • Messages d’erreur
  • Texte de l’image associée

Vous pouvez traduire tous les textes destinés à l’utilisateur dans les rubriques et les cartes adaptatives à l’aide d’un seul workflow.

Quelle est l’apparence statique du texte de la carte adaptative dans les fichiers de localisation

Lorsque vous exportez un fichier de localisation pour une langue secondaire, le texte statique des cartes adaptatives apparaît comme des entrées aux côtés de vos chaînes de rubriques.

Chaque entrée comprend un chemin de clé unique qui indique où se situe le texte dans la structure de dialogue, de rubrique et de carte. Bien que les clés soient longues, il suffit de traduire les valeurs.

Exemple (tronqué) :

{
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[0].text": "Purchase request",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[2].columns[0].items[0].text": "Requested by",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[2].columns[1].items[0].text": "Department",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[3].facts[0].title": "Request ID",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[3].facts[1].title": "Total",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[0].title": "Approve",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[1].title": "Reject",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[2].title": "View details"
}

Gérer les chaînes de contenu mixte avec SetTextVariable

Certaines chaînes dans les cartes adaptatives contiennent une combinaison de texte statique et de valeurs dynamiques. Par exemple :

Vous approuvez la demande PR-20417 totalisant 1 245,80 $ pour Contoso Research

L’ID de la requête, le montant total et l’unité métier sont variables. Le texte d’accompagnement doit être traduit. Copilot Studio ne peut pas extraire automatiquement le texte statique à partir de contenu mixte, donc ces valeurs n’apparaissent pas dans le fichier de localisation.

Utilisez le nœud Définir une variable de texte pour le contenu mixte localisable

Copilot Studio inclut le nœud Définir la variable de teste, disponible uniquement via l’éditeur de code. Ce nœud vous permet :

  • Combinez du texte statique et des espaces réservés variables.
  • Produire une seule chaîne qui apparaît dans les fichiers de localisation.
  • Préserver la structure des variables pendant la translation.

En savoir plus dans Rendez le contenu dynamique des cartes adaptatives disponible pour la localisation.

Exportez votre fichier de localisation et traduisez le texte statique

Lorsque vous téléchargez le fichier de localisation, il contient la chaîne complète de contenu mixte avec des espaces réservés.

Par exemple :

{
  "'dialog(copilots_header_392e9.topic.recommendbooks)'.'trigger(main)'.'action(readingProgress)'.Value":
    "You are approving request {Topic.requestId} totaling {Topic.formattedTotal} for {Topic.businessUnit}"
}

Traduisez uniquement le texte statique et conservez les espaces réservés inchangés.

Points clés

  • Le texte statique de la carte adaptative apparaît dans les fichiers de localisation, ce qui permet de traduire de manière cohérente tout le contenu destiné à l’utilisateur.
  • Les cartes adaptatives ne nécessitent pas plusieurs versions ni d’expressions conditionnelles pour les expériences multilingues.
  • Utilisez un nœud Définir la variable de texte pour du contenu mixte statique et dynamique afin de garantir que les espaces réservés et le texte environnant soient entièrement localisables.

Ce workflow unifié simplifie le processus de localisation et facilite la création d’expériences utilisateur globales dans Copilot Studio.

  • Last updated on