Localizar o conteúdo do Cartão Adaptativo

Ao utilizar Cartões Adaptativos, pode apresentar informação avançada e estruturada aos utilizadores dos agentes do Copilot Studio. Para agentes multilingues, certifique-se de que localiza completamente tanto o conteúdo do tópico como o texto do Cartão Adaptativo. Ao utilizar Cartões Adaptativos, pode conceber e integrar IUs simples em todas as principais plataformas e estruturas.

O Copilot Studio suporta a localização de texto estático em Cartões Adaptativos através dos mesmos ficheiros de localização JSON/ResX que já utiliza para tópicos.

Este artigo explica o fluxo de trabalho de localização, como traduzir o texto do Cartão Adaptativo e como lidar com conteúdos mistos que contenham valores estáticos e dinâmicos.

Antes de começar

Familiarize-se com os seguintes conceitos:

Compreender os fluxos de trabalho de localização

O Copilot Studio inclui todo o texto estático dos Cartões Adaptativos nos seus ficheiros de localização exportados. Este texto inclui:

  • Valores TextBlock
  • Títulos de botões
  • Texto do marcador de posição
  • Mensagens de erro
  • Texto alternativo da imagem

Pode traduzir todo o texto dirigido ao utilizador em tópicos e Cartões Adaptativos através de um único fluxo de trabalho de tradução.

Como o texto estático dos Cartões Adaptativos aparece nos ficheiros de localização

Ao exportar um ficheiro de localização para qualquer idioma secundário, o texto estático do cartão aparece como entradas juntamente com as cadeias de tópicos.

Cada entrada inclui um caminho de chave exclusivo que identifica onde o texto existe na estrutura do diálogo, tópico e cartão. Embora as chaves sejam extensas, apenas é necessário 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"
}

Processar cadeias de conteúdo misto com SetTextVariable

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

Está a aprovar o pedido PR‑20417, totalizando 1.245,80 $ para a Contoso Research

O ID do pedido, o montante total e a unidade de negócio são variáveis. O texto envolvente precisa de tradução. O Copilot Studio não consegue extrair automaticamente texto estático de conteúdos mistos, por isso estes valores não aparecem no ficheiro de localização.

Utilize o nó Definir Variável de Texto para conteúdo misto localizável

O Copilot Studio inclui o nó Definir variável de texto, disponível apenas através do editor de código. Este nó permite que:

  • Combine texto estático e marcadores de posição variáveis.
  • Produza uma única cadeia que esteja presente nos ficheiros de localização.
  • Mantenha a estrutura das variáveis durante a tradução.

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

Exportar o ficheiro de localização e traduzir apenas o texto estático

Quando transfere o ficheiro de localização, este contém a cadeia completa de conteúdo misto com marcadores de posição.

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 marcadores de posição das variáveis inalterados.

Principais conclusões

  • O texto estático do Cartão Adaptativo aparece em ficheiros de localização, para que possa traduzir consistentemente todo o conteúdo dirigido ao utilizador.
  • Os Cartões Adaptativos não requerem múltiplas versões ou expressões condicionais para experiências multilingues.
  • Utilize um nó Definir variável de texto para o conteúdo estático e dinâmico misto para assegurar que os marcadores de posição e o texto circundante são totalmente localizáveis.

Este fluxo de trabalho unificado simplifica o processo de localização e facilita a criação de experiências de utilizador prontas para o mercado global no Copilot Studio.

  • Last updated on