Lokaliser indhold i Adaptive kort

Ved at bruge Adaptive kort kan du præsentere rig, struktureret information for brugere af Copilot Studio-agenter. For flersprogede agenter skal du sørge for at lokalisere både dit emneindhold og Adaptive kort-tekst fuldt ud. Ved hjælp af adaptive kort kan du designe og integrere letvægtsbrugergrænsefladen til alle større platforme og strukturer.

Copilot Studio understøtter lokalisering af statisk tekst i Adaptive kort via de samme JSON/ResX-lokaliseringsfiler, som du allerede bruger til emner.

Denne artikel forklarer lokaliseringsarbejdsprocessen, hvordan du oversætter Adaptive kort-tekst, og hvordan du håndterer blandet indhold, der indeholder både statiske og dynamiske værdier.

Inden du starter

Bliv fortrolig med følgende begreber:

Forstå lokaliseringsarbejdsgange

Copilot Studio inkluderer al statisk Adaptive kort-tekst i dine eksporterede lokaliseringsfiler. Teksten inkluderer:

  • TextBlock-værdier
  • Knaptitler
  • Pladsholdertekst
  • Fejlmeddelelser
  • Billede-alternativ tekst

Du kan oversætte al brugerrettet tekst i emner og Adaptive kort gennem et samlet oversættelsesworkflow.

Hvordan statisk Adaptive kort-tekst vises i lokaliseringsfiler

Når du eksporterer en lokaliseringsfil for et sekundært sprog, vises den statiske korttekst som poster sammen med dine emnestrenge.

Hver post indeholder en unik nøglesti, der identificerer, hvor teksten findes i dialogen, emnet og kortstrukturen. Selvom nøglerne er meget detaljerede, behøver du kun at oversætte værdierne.

Eksempel (forkortet):

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

Håndter strenge med blandet indhold med SetTextVariable

Nogle strenge i Adaptive kort kan bestå af både statisk tekst og dynamiske værdier. Eksempel:

Du godkender anmodning PR-20417, med samlet beløb på $1.245,80 for Contoso Research

Anmodnings-id, det samlede beløb og afdeling er variabler. Den omgivende tekst trænger til oversættelse. Copilot Studio kan ikke automatisk udtrække statisk tekst fra blandet indhold, så disse værdier vises ikke i lokaliseringsfilen.

Brug Angiv tekstvariabel-noden til blandet indhold, der kan lokaliseres

Copilot Studio inkluderer Angiv tekstvariabel-noden, som kun er tilgængelig via kodeeditoren. Med denne node kan du:

  • Kombinere statisk tekst og variabelpladsholdere.
  • Producere en enkelt streng, der optræder i lokaliseringsfiler.
  • Bevare variabelstrukturen under oversættelse.

Læs mere i Gør dynamisk indhold fra Adaptive kort tilgængeligt for lokalisering.

Eksportér din lokaliseringsfil, og oversæt statisk tekst

Når du downloader lokaliseringsfilen, indeholder den hele den blandede tekststreng med pladsholdere.

Eksempel:

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

Oversæt kun den statiske tekst, og bevar de variable pladsholdere uændrede.

Vigtige takeaways

  • Statisk Adaptive kort-tekst vises i lokaliseringsfiler, så du konsekvent kan oversætte alt brugerrettet indhold.
  • Adaptive kort kræver ikke flere versioner eller betingede udtryk for flersprogede oplevelser.
  • Brug en Angiv tekstvariabel-node til blandet statisk og dynamisk indhold for at sikre, at pladsholdere og omgivende tekst er fuldt lokaliserbare.

Denne ensartede arbejdsproces forenkler lokaliseringsprocessen og gør det lettere at bygge brugeroplevelser, der er klar til global anvendelse, i Copilot Studio.