Localizar el contenido de tarjeta adaptable

Utilizando Tarjeta adaptables, puede presentar información rica y estructurada a los usuarios de los agentes de Copilot Studio. Para agentes multilingües, asegúrese de localizar por completo tanto el contenido temático como el texto de la Tarjeta adaptable. Al usar las tarjetas adaptables, puede diseñar e integrar una interfaz de usuario ligera para las principales plataformas y marcos.

Copilot Studio admite la localización de texto estático en las Tarjetas adaptables mediante los mismos archivos de localización JSON/ResX que ya utiliza para los temas.

Este artículo explica el flujo de trabajo de localización, cómo traducir texto de Tarjeta adaptable y cómo gestionar contenido mixto que contiene valores tanto estáticos como dinámicos.

Antes de comenzar

Familiarícese con los conceptos siguientes:

Comprenda los flujos de trabajo de localización

Copilot Studio incluye todo el texto estático de Tarjeta adaptables en sus archivos de localización exportados. Este texto incluye:

  • Valores de TextBlock
  • Títulos de botones
  • Texto de marcador de posición
  • Mensajes de error
  • Texto alternativo de la imagen

Puede traducir todo el texto orientado al usuario en temas y Tarjetas adaptables mediante un único flujo de trabajo de traducción.

Cómo se muestra el texto estático de las Tarjetas adaptables en los archivos de localización

Al exportar un archivo de localización para cualquier idioma secundario, el texto de la tarjeta estática aparece como entradas junto con las cadenas de tema.

Cada entrada incluye una ruta de clave única que identifica dónde existe el texto en la estructura de diálogo, tema y tarjeta. Aunque las claves son detalladas, solo necesita traducir los valores.

Ejemplo (truncado):

{
  "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"
}

Manejar cadenas de contenido mixto con SetTextVariable

Algunas cadenas en Tarjetas adaptables contienen una combinación de texto estático y valores dinámicos. Por ejemplo:

Estás aprobando la solicitud PR-20417 por un total de 1.245,80 $ para Contoso Research

El id. de la solicitud, el importe total y la unidad de negocio son variables. El texto que lo rodea necesita traducción. Copilot Studio no puede extraer automáticamente texto estático de contenido mixto, por lo que estos valores no aparecen en el archivo de localización.

Utiliza el nodo Set Text Variable para contenido mixto localizable

Copilot Studio incluye el nodo Establecer variable de texto, disponible solo a través del editor de código. Este nodo le permite:

  • Combine texto estático y marcadores de posición variables.
  • Produce una sola cadena que aparece en los archivos de localización.
  • Conserve la estructura de las variables durante la traducción.

Obtenga más información en Habilitar el contenido dinámico de Tarjetas adaptables para la localización.

Exportar su archivo de localización y traduce texto estático

Cuando descarga el archivo de localización, contiene la cadena completa de contenido mixto con marcadores de posición.

Por ejemplo:

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

Traduzca solo el texto estático y mantenga los marcadores de posición de variables sin cambios.

Puntos clave de aprendizaje

  • El texto estático de la Tarjeta Adaptable aparece en los archivos de localización, por lo que puede traducir de forma consistente todo el contenido orientado al usuario.
  • Las Tarjetas adaptables no requieren varias versiones ni expresiones condicionales para experiencias multilingües.
  • Use un nodo Set text variable para contenido mixto (estático y dinámico) y asegurarse de que los marcadores de posición y el texto circundante sean totalmente localizables.

Este flujo de trabajo unificado simplifica el proceso de localización y facilita la creación de experiencias de usuario globales en Copilot Studio.

  • Last updated on