Localizzare il contenuto della scheda adattiva

Utilizzando Schede adattive, puoi presentare informazioni ricche e strutturate agli utenti degli agenti di Copilot Studio. Per gli agenti multilingue, assicurati di localizzare completamente sia il contenuto degli argomenti che il testo delle Schede adattive. Con le schede adattive, puoi progettare e integrare un'interfaccia utente leggera per tutte le principali piattaforme e framework.

Copilot Studio supporta la localizzazione di testo statico in Schede adattive tramite gli stessi file di localizzazione JSON/ResX che già usi per gli argomenti.

Questo articolo spiega il flusso di lavoro di localizzazione, come tradurre il testo Scheda adattiva e come gestire contenuti misti che contengono sia valori statici che dinamici.

Prima di iniziare

Vieni a conoscere bene i concetti seguenti:

Comprendere i flussi di lavoro di localizzazione

Copilot Studio include tutto il testo statico delle Schede adattive nei file di localizzazione esportati. Questo testo include:

  • Valori TextBlock
  • Titoli dei pulsanti
  • Testo segnaposto
  • Messaggi di errore
  • Testo alternativo immagine

Puoi tradurre tutti i testi rivolti all'utente negli argomenti e nelle Schede adattive tramite un unico flusso di lavoro di traduzione.

Come appare il testo statico delle Schede adattive nei file di localizzazione

Quando esporti un file di localizzazione per qualsiasi lingua secondaria, il testo della scheda statica viene visualizzato come voci insieme alle stringhe di argomento.

Ogni voce include un percorso di chiave univoco che identifica la posizione in cui il testo esiste nella finestra di dialogo, nell'argomento e nella struttura della scheda. Anche se le chiavi sono dettagliate, devi solo tradurre i valori.

Esempio (troncato):

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

Gestire stringhe di contenuto misto con SetTextVariable

Alcune stringhe delle Schede adattive contengono una combinazione di testo statico e valori dinamici. Ad esempio:

Stai approvando la richiesta PR‑20417 che ammonta a 1.245,80 USD per Contoso Research

L'ID della richiesta, l'importo totale e l'unità di business sono variabili. Il testo circostante deve essere tradotto. Copilot Studio non può estrarre automaticamente il testo statico da contenuti misti, quindi questi valori non compaiono nel file di localizzazione.

Utilizza il nodo Imposta variabile di testo per contenuto misto localizzabile

Copilot Studio include il nodo Imposta variabile di testo, disponibile solo tramite l'editor di codice. Questo nodo consente di:

  • Combina testo statico e placeholder delle variabili.
  • Produce una singola stringa che appare nei file di localizzazione.
  • Preserva la struttura delle variabili durante la traduzione.

Altre informazioni in Rendere disponibili i contenuti dinamici delle schede adattive per la localizzazione.

Esporta il file di localizzazione e traduci i testi statici

Quando scarichi il file di localizzazione, esso contiene l'intera stringa composta da testo statico e segnaposto.

Ad esempio: 

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

Traduci solo il testo statico e mantieni invariati i segnaposto variabili.

Punti chiave

  • Il testo statico della Scheda Adattiva viene visualizzato nei file di localizzazione, così puoi tradurre in modo coerente tutti i contenuti rivolti all'utente.
  • Le Schede adattive non richiedono versioni multiple o espressioni condizionate per esperienze multilingue.
  • Usa un nodo Imposta variabile di testo per contenuti statici e dinamici misti, per assicurarti che i segnaposto e il testo circostante siano completamente localizzabili.

Questo flusso di lavoro unificato semplifica il processo di localizzazione e facilita la creazione di esperienze utente pronte per il mercato globale in Copilot Studio.

  • Last updated on