Lokaliser innhold i dynamiske kort

Ved å bruke dynamiske kort kan du presentere rik, strukturert informasjon til brukere av Copilot Studio-agenter. For flerspråklige agenter må du sørge for at både emneinnholdet og teksten i dynamiske kort blir fullt ut lokalisert. Ved å bruke dynamiske kort kan du utforme og integrere enkle brukergrensesnitt for alle større plattformer og rammeverk.

Copilot Studio støtter lokalisering av statisk tekst i dynamiske kort gjennom de samme JSON/ResX-lokaliseringsfilene du allerede bruker for emner.

Denne artikkelen forklarer lokaliseringsflyten, hvordan du oversetter tekst i dynamiske kort, og hvordan du håndterer blandet innhold som inneholder både statiske og dynamiske verdier.

Før du starter

Gjør deg kjent med følgende konsepter:

Forstå arbeidsflyter for lokalisering

Copilot Studio inkluderer all statisk tekst i dynamiske kort i de eksporterte lokaliseringsfilene. Denne teksten omfatter:

  • TextBlock-verdier
  • Knapptitler
  • Plassholdertekst
  • Feilmeldinger
  • Bildealternativ tekst

Du kan oversette all brukerrettet tekst i emner og dynamiske kort gjennom en enkelt oversettelsesarbeidsflyt.

Hvordan statisk tekst i dynamisk kort vises i lokaliseringsfiler

Når du eksporterer en lokaliseringsfil for et sekundært språk, vises den statiske kortteksten som oppføringer sammen med emnestrengene dine.

Hver oppføring inkluderer en unik nøkkelsti som identifiserer hvor teksten befinner seg i dialogboksen, emnet og kortstrukturen. Selv om nøklene er ordrike, trenger du bare å oversette verdiene.

Eksempel (avkortet):

{
  "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 strenger med blandet innhold med SetTextVariable

Noen strenger i dynamiske kort inneholder en kombinasjon av statisk tekst og dynamiske verdier. Eksempel:

Du godkjenner forespørsel PR-20417 på totalt 1245,80 dollar for Contoso Research

Forespørsels-ID, totalbeløp og forretningsenhet er variabler. Teksten rundt må oversettes. Copilot Studio kan ikke automatisk trekke ut statisk tekst fra blandet innhold, så den statiske teksten vises ikke i lokaliseringsfilen.

Bruk Angi tekstvariabel-noden for blandet innhold som kan lokaliseres

Copilot Studio inkluderer Angi tekstvariabel-noden, som bare er tilgjengelig via koderedigeringsprogrammet. Med denne noden kan du gjøre følgende:

  • Kombiner statisk tekst og variable plassholdere.
  • Generer én tekststreng som vises i lokaliseringsfilene.
  • Bevar variabelstruktur under lokalisering.

Les mer i Gjør dynamisk innhold fra dynamiske kort tilgjengelig for lokalisering.

Eksporter lokaliseringsfilen og oversett statisk tekst

Når du laster ned lokaliseringsfilen, inneholder den den komplette blandede tekststrengen med plassholdere.

Eksempel:

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

Oversett bare den statiske teksten og la variabelplassholderne være uendret.

Viktige punkter

  • Statisk tekst i dynamiske kort blir inkludert i lokaliseringsfiler, slik at du konsekvent kan oversette alt brukerrettet innhold.
  • Dynamiske kort krever ikke flere versjoner eller betingede uttrykk for flerspråklige opplevelser.
  • Bruk Angi tekstvariabel-noden for blandet statisk og dynamisk innhold for å sikre at plassholdere og omkringliggende tekst er fullt lokaliserbare.

Denne enhetlige arbeidsflyten forenkler lokaliseringsprosessen og gjør det enklere å bygge globale brukeropplevelser i Copilot Studio.

  • Last updated on