Torna al blog

Reliability · 19 ago 2026

Proteggi segnaposto, link e identificatori nella traduzione AI

Un output fluido non basta quando un token modificato può rompere la pagina. I flussi di traduzione devono proteggere i contenuti funzionali prima che la generazione inizi.

Proteggi segnaposto, link e identificatori nella traduzione AI

Alcune delle parti più importanti di una traduzione non dovrebbero essere tradotte affatto.

Variabili, URL, ID di voce, riferimenti a risorse, esempi di codice e marcatori di formattazione svolgono una funzione piuttosto che essere prosa. Un modello può produrre una frase dal suono naturale modificando silenziosamente uno di questi elementi e compromettendo l’esperienza che li circonda.

Una traduzione AI affidabile inizia separando la lingua dalla struttura.

Identifica il contenuto protetto prima del prompt

Non fare affidamento su un’istruzione generica come "preserve placeholders." Per prima cosa identifica i token e i nodi esatti che devono rimanere invariati.

Il contenuto protetto include comunemente:

  • variabili di interpolazione come {first_name} o {{ total }}
  • sintassi dei messaggi ICU e selettori di plurale
  • URL, indirizzi email e frammenti di route
  • attributi HTML e destinazioni dei link markdown
  • riferimenti a entry e asset di Contentful
  • segmenti di codice inline, blocchi di codice delimitati e valori API
  • nomi di prodotto contrassegnati come non traducibili

Il modello di contenuto e il tipo di campo dovrebbero aiutare a determinare le regole di protezione. Un documento rich-text richiede una gestione strutturale diversa da quella di un titolo in testo semplice.

Sostituisci i valori rischiosi con token stabili

Per le stringhe semplici, un approccio robusto consiste nell’estrarre i valori protetti e sostituirli con token temporanei non ambigui prima della traduzione.

Il modello vede la lingua circostante ma non può riscrivere accidentalmente un URL di destinazione o un identificatore. Dopo la generazione, il flusso di lavoro ripristina i valori originali da una mappa lato server.

I token dovrebbero essere univoci, difficili da confondere con il linguaggio naturale e convalidati prima del ripristino. Non fidarti mai del modello perché riproduca la mappa stessa.

Traduci il rich text come struttura

Appiattire un albero rich-text in markdown o HTML può far perdere distinzioni importanti.

I nodi di testo sono traducibili. Link, entry incorporate, tipi di nodo e marcature sono strutturali. Attraversa l’albero del documento, traduci le foglie di testo idonee e ricostruisci la gerarchia originale lasciando intatti i riferimenti.

Questo migliora anche la revisione. Gli editor possono confrontare la stessa struttura in entrambe le lingue invece di esaminare un’approssimazione serializzata che può nascondere nodi mancanti o riordinati.

Convalida l’output prima di salvarlo

La protezione richiede un ciclo chiuso.

Dopo la traduzione, verifica che ogni token previsto appaia esattamente dove il formato lo consente e che non sia stato introdotto alcun token sconosciuto. Analizza i formati strutturati invece di controllarli con un confronto approssimativo di stringhe.

Gli errori utili sono specifici:

  • segnaposto {total} mancante
  • destinazione del link modificata nel campo ctaBody
  • sintassi ICU non valida nella lingua de
  • conteggio imprevisto dei nodi rich-text

Rifiutare output malformati a questo confine è più sicuro che lasciare che il problema emerga durante il rendering o, peggio, dopo la pubblicazione.

Mostra gli elementi protetti nella revisione

I revisori dovrebbero poter riconoscere i contenuti funzionali senza esserne distratti.

Usa uno stile discreto per segnaposto e termini protetti. Rendi modificabile il testo del link mantenendo visibile la destinazione e controllandola separatamente. Per i contenuti incorporati, mostra un’etichetta leggibile dall’essere umano accanto all’ID immutabile.

Se un revisore deve intenzionalmente cambiare un URL per un mercato target, trattalo come una decisione distinta di campo localizzato piuttosto che come un effetto collaterale accidentale della traduzione della prosa.

Esegui test con esempi avversari

Il percorso ideale non basta. Includi stringhe con variabili ripetute, punteggiatura adiacente, markdown annidato, forme plurali, testo da destra a sinistra e segnaposto che assomigliano a parole comuni.

La logica di protezione dovrebbe dimostrare di poter gestire questi casi senza perdite prima di essere considerata affidabile per contenuti di produzione.

Il punto chiave

La qualità della traduzione include l’integrità funzionale.

Estrai il contenuto protetto, traduci solo la lingua idonea, preserva la struttura rich-text, convalida il risultato e rendi chiari gli elementi funzionali durante la revisione. Una frase fluida ha valore solo se la pagina continua a funzionare dopo la pubblicazione.