Lokalisoi mukautuvan kortin sisältö

Mukautuvia kortteja käyttämällä Copilot Studio -agenttien käyttäjille voidaan tarjota monipuolisia ja jäsennettyjä tietoja. Monikielisissä agenteissa on varmistettava, että sekä aiheiden sisältö että mukautuvan kortin teksti lokalisoidaan. Mukautuvien korttien avulla voit suunnitella ja integroida kevyen käyttöliittymän kaikille tärkeimmille ympäristöille ja kehyksille.

Copilot Studio tukee mukautuvien korttien staattisen tekstin lokalisointia samoissa JSON/ResX-lokalisointitiedostoissa, joita käytetään myös aiheissa.

Tässä artikkelissa käsitellään lokalisointityönkulkua, mukautuvien korttien tekstin kääntämistä ja sekä staattisia ja dynaamisia arvoja sisältävän yhdistelmäsisällön käsittelyä.

Alkutoimet

Seuraaviin käsitteisiin tutustuminen:

Lokalisointityönkulkujen ymmärtäminen

Copilot Studio sisällyttää mukautuvan kortin kaiken staattisen tekstin vietäviin lokalisaatiotiedostoihin. Tekstin sisältö:

  • TextBlock-arvot
  • Painikkeiden otsikot
  • Paikkamerkkiteksti
  • Virhesanomat
  • Kuvan vaihtoehtoinen teksti

Kaikki aiheissa ja mukautuvissa korteissa käyttäjälle näkyvä teksti voidaan kääntää yhtenä käännöstyönkulkuna.

Mukautuvan kortin staattinen tekstin näkyminen lokalisointitiedostoissa

Kun lokalisointitiedosto viedään johonkin toissijaiseen kieleen, kortin staattinen teksti näkyy merkintöinä aihemerkkijonojen rinnalla.

Kukin merkintä sisältää yksilöivän avainpolun, joka osoittaa, missä teksti sijaitsee valintaikkunassa, aiheessa ja korttirakenteessa. Vaikka avaimet ovat sanallisia, vain arvot tarvitsee kääntää.

Esimerkki (lyhennetty):

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

Yhdistelmäsisältöisten merkkijonojen käsittely SetTextVariable-solmun avulla

Joissakin mukautuvien korttien merkkijonoissa on yhdistelmä staattista tekstiä ja dynaamisia arvoja. Esimerkki:

Hyväksyt pyynnön PR-20417, jonka kokonaissumma on 1 245,80 USD ja saaja Contoso Research

Pyynnön tunnus, kokonaissumma ja liiketoimintayksikkö ovat muuttujia. Ympäröivä teksti on käännettävä. Copilot Studio ei voi automaattisesti poimia staattista tekstiä yhdistelmäsisällöstä, joten nämä arvot eivät näy lokalisointitiedostossa.

Määritä tekstimuuttuja -solmun käyttäminen lokalisoitavassa yhdistelmäsisällössä

Copilot Studio sisältää Määritä tekstimuuttuja -solmu, jota voi käyttää vain koodieditorissa. Seuraavat ovat mahdollisia solmussa:

  • Staattinen tekstin ja muuttujapaikkamerkkien yhdistäminen.
  • Lokalisointitiedostoissa näkyvän yhden merkkijonon tuottaminen.
  • Muuttujarakenteen säilyttäminen kääntämisen aikana.

Lisätietoja on kohdassa Mukautuvien korttien dynaaminen sisällön lokalisoinnin mahdollistaminen.

Lokalisointitiedoston vieminen ja staattisen tekstin kääntäminen

Ladattava lokalisointitiedosto sisältää koko yhdistelmäsisällön merkkijonon paikkamerkkeineen.

Esimerkki:

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

Käännä vain staattinen teksti ja äläkä muuta paikkamerkkejä.

Tärkeimmät seikat

  • Mukautuvan kortin staattinen teksti näkyy lokalisaatiotiedostoissa, joten kaikki käyttäjälle suunnattu sisältö voidaan kääntää yhdenmukaisesti.
  • Mukautuvat kortit eivät vaadi useita versioita tai ehdollisia lausekkeita monikielisiä käyttökokemuksia varten.
  • Käytä Määritä tekstimuuttuja -solmua, kun kyseessä on yhdistelmä staattista ja dynaamista sisältöä. Näin varmistetaan, että paikkamerkit ja ympäröivä teksti ovat kokonaisuudessa lokalisoitavissa.

Tämä yhtenäinen työnkulku yksinkertaistaa lokalisointiprosessia ja helpottaa maailmanlaajuisesti käyttövalmiiden käyttäjäkokemusten kehittämistä Copilot Studiossa.

  • Last updated on