Adaptieve-kaartinhoud lokaliseren

Met behulp van adaptieve kaarten kunt u rijke, gestructureerde informatie presenteren aan gebruikers van Copilot Studio-agenten. Voor meertalige agenten is het belangrijk dat u zowel de inhoud van uw onderwerpen als de tekst van de adaptieve kaarten volledig lokaliseert. Met adaptieve kaarten kunt u een lichtgewicht gebruikersinterface ontwerpen en integreren voor alle belangrijke platforms en frameworks.

Copilot Studio ondersteunt de lokalisatie van statische tekst in adaptieve kaarten via dezelfde JSON/ResX-lokalisatiebestanden die u al voor onderwerpen gebruikt.

Dit artikel beschrijft de lokalisatieworkflow, hoe u de tekst van adaptieve kaarten vertaalt en hoe u omgaat met gemengde inhoud die zowel statische als dynamische waarden bevat.

Voordat u begint

Maak uzelf vertrouwd met de volgende concepten:

De lokalisatieworkflows begrijpen

Copilot Studio neemt alle statische tekst van adaptieve kaarten op in uw geëxporteerde lokalisatiebestanden. Deze tekst bevat:

  • TextBlock waarden
  • Knoptitels
  • Tekst van tijdelijke aanduiding
  • Foutberichten
  • Alternatieve tekst van afbeelding

U kunt alle gebruikersgerichte tekst in onderwerpen en adaptieve kaarten vertalen via één vertaalworkflow.

Hoe statische tekst van adaptieve kaarten wordt weergegeven in lokalisatiebestanden

Wanneer u een lokalisatiebestand exporteert voor een secundaire taal, verschijnt de statische kaarttekst als vermeldingen naast uw onderwerpteksten.

Elke vermelding bevat een uniek sleutelpad dat aangeeft waar de tekst zich bevindt in de dialoog-, onderwerp- en kaartstructuur. Hoewel de sleutels uitgebreid zijn, hoeft u alleen de waarden te vertalen.

Voorbeeld (afgekapt):

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

Verwerk strings met gemengde inhoud met SetTextVariable

Sommige strings in adaptieve kaarten bevatten een combinatie van statische tekst en dynamische waarden. Bijvoorbeeld:

U keurt aanvraag PR-20417 goed met een totaalbedrag van $ 1.245,80 voor Contoso Research

De aanvraag-ID, het totaalbedrag en de bedrijfseenheid zijn variabelen. De omringende tekst moet worden vertaald. Copilot Studio kan statische tekst niet automatisch extraheren uit gemengde inhoud, waardoor deze waarden niet in het lokalisatiebestand verschijnen.

Gebruik het knooppunt Tekstvariabele instellen voor lokaliseerbare gemengde inhoud

Copilot Studio bevat het knooppunt 'Tekstvariabele instellen', dat alleen beschikbaar is via de code-editor. Met dit knooppunt kunt u:

  • Statische tekst en variabele tijdelijke aanduidingen combineren.
  • Een enkele tekenreeks produceren die in lokalisatiebestanden verschijnt.
  • De variabele structuur behouden tijdens de vertaling.

Lees meer in Dynamische inhoud van adaptieve kaarten beschikbaar maken voor lokalisatie.

Uw lokalisatiebestand exporteren en statische tekst vertalen

Wanneer u het lokalisatiebestand downloadt, bevat het de volledige tekenreeks met gemengde inhoud met tijdelijke aanduidingen.

Bijvoorbeeld:

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

Alleen de statische tekst vertalen en de variabele placeholders ongewijzigd laten.

Belangrijkste punten

  • Statische tekst van adaptieve kaarten verschijnt in lokalisatiebestanden, zodat u alle gebruikersgerichte inhoud consistent kunt vertalen.
  • Adaptieve kaarten vereisen geen meerdere versies of voorwaardelijke expressies voor meertalige ervaringen.
  • Gebruik een Tekstvariabele instellen-node voor gemengde statische en dynamische content om ervoor te zorgen dat placeholders en omringende tekst volledig lokaliseerbaar zijn.

Deze uniforme workflow vereenvoudigt het lokalisatieproces en maakt het gemakkelijker om wereldwijd inzetbare gebruikerservaringen te bouwen in Copilot Studio.

  • Last updated on