Localizar o conteúdo do Cartão Adaptável

Ao usar Cartões Adaptáveis, você pode apresentar informações ricas e estruturadas aos usuários dos agentes do Copilot Studio. Para agentes multilíngues, certifique-se de localizar totalmente tanto o conteúdo do tema quanto o texto do Cartão Adaptável. Usando Cartões Adaptáveis, você pode projetar e integrar uma interface do usuário leve para todas as principais plataformas e estruturas.

O Copilot Studio suporta a localização de texto estático em Cartões Adaptáveis por meio dos mesmos arquivos de localização JSON/ResX que você já utiliza para tópicos.

Este artigo explica o fluxo de trabalho de localização, como traduzir o texto do Cartão Adaptável e como lidar com conteúdo misto que contém valores estáticos e dinâmicos.

Antes de começar

Familiarize-se com os seguintes conceitos:

Entenda os fluxos de trabalho de localização

O Copilot Studio inclui todo o texto estático dos Cartões Adaptáveis em seus arquivos de localização exportados. Este texto inclui:

  • valores TextBlock
  • Títulos dos botões
  • Texto de espaço reservado
  • Mensagens de erro
  • Texto alt da imagem

É possível traduzir todo o texto voltado para o usuário nos tópicos e nos Cartões Adaptáveis por meio de um único fluxo de trabalho de tradução.

Como o texto estático do Cartão Adaptável aparece nos arquivos de localização

Quando você exporta um arquivo de localização para qualquer idioma secundário, o texto do cartão estático aparece como entradas ao lado de suas cadeias de caracteres de tópico.

Cada entrada inclui um caminho de chave exclusivo que identifica onde o texto existe na caixa de diálogo, tópico e estrutura de cartão. Embora as chaves sejam detalhadas, você só precisa traduzir os valores.

Exemplo (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"
}

Trate cadeias de caracteres com conteúdo misto usando SetTextVariable

Algumas cadeias de caracteres nos Cartões Adaptáveis contêm uma combinação de texto estático e valores dinâmicos. Por exemplo:

Você está aprovando a solicitação PR‑20417 no valor total de US$ 1.245,80 para Contoso Research

A ID da solicitação, o valor total e a unidade de negócio são variáveis. O texto que envolve os valores precisa ser traduzido. O Copilot Studio não consegue identificar automaticamente o texto estático em conteúdo misto, portanto esses valores não aparecem no arquivo de localização.

Usar o nó Configurar Variável de Texto para conteúdo misto que pode ser localizado

O Copilot Studio inclui o nó Definir variável de texto, disponível somente por meio do editor de código. Esse nó permite:

  • Combinar texto estático e espaços reservados variáveis.
  • Produzir uma única cadeia de caracteres que aparece nos arquivos de localização.
  • Preserve a estrutura das variáveis durante a tradução.

Saiba mais em Disponibilizar o conteúdo dinâmico dos Cartões Adaptáveis para localização.

Exporte seu arquivo de localização e traduza o texto estático

Quando você baixa o arquivo de localização, ele contém a string de conteúdo misto completa com espaços reservados.

Por exemplo:

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

Traduza apenas o texto estático e mantenha os espaços reservados inalterados.

Principais conclusões

  • O texto estático do Cartão Adaptável aparece nos arquivos de localização, para que você possa traduzir de forma consistente todo o conteúdo exibido ao usuário.
  • Os Cartões Adaptáveis não exigem várias versões nem expressões condicionais para experiências multilíngues.
  • Use um nó de Definir variável de texto para conteúdo estático e dinâmico misto para garantir que os espaços reservados e o texto ao redor sejam totalmente localizáveis.

Esse fluxo de trabalho unificado simplifica o processo de localização e facilita a criação de experiências de usuário preparadas para o mercado global no Copilot Studio.

  • Last updated on