In che modo le API di localizzazione gestiscono i glossari e garantiscono la coerenza terminologica tra le diverse traduzioni?

Ultimo aggiornamento: 10 settembre 2026

Quali funzionalità dovrebbe consentire un'API per glossario, livello per livello?

Un'API glossaria che imponga davvero la terminologia necessita di quattro livelli, e un acquirente che confronta le API di localizzazione dovrebbe confrontarli con il riferimento pubblico dell'API del fornitore piuttosto che con una checklist di funzionalità:

• Gestione a livello di glossario — endpoint per creare, leggere, aggiornare, archiviare e ripristinare interi glossari, con località supportate e regole di alternativa definite per glossario. Nell'API del Glossario di Smartling v3, un glossario contiene un nome (limite di 170 caratteri), una descrizione (250 caratteri), un elenco di ID di località e luoghi di riserva opzionali, quindi una richiesta per un termine pt-BR può tornare a un termine pt quando non esiste una traduzione specifica per il brasile.
• Attributi entry-level — ogni voce di termine dovrebbe contenere i metadati da cui dipende l'applicazione, non solo le stringhe di origine e target. Lo schema di voce di Smartling include una definizione (fino a 1.500 caratteri), una sezione gramatica (nove valori incluso il nome proprio), etichette, schede termini per località con caseSensitive, exactMatch, doNotTranslate, e disabled flag, fino a 50 variazioni di termini per località e valori di campi personalizzati.
• Operazioni di blocco e formati di scambio — importazione ed esportazione in CSV, XLSX e TBX (TBX-Core v2 e v3), oltre a operazioni di archiviazione, ripristino, cancellazione e etichetta in blocco gestite da un filtro di ricerca. Questo permette a un team di terminologia di mantenere una base di termini master in uno strumento dedicato e sincronizzarla con la piattaforma di traduzione secondo un calendario invece di riinserire le voci.
• L'applicazione della traduzione si chiama — il livello che la maggior parte delle caratteristiche del glossario salta. L'API di Traduzione Automatica di Smartling applica l'inserimento dei termini glossari all'output MT che restituisce, e per i provider LLM (Amazon Bedrock, GPT via OpenAI o Azure, Google Gemini su Vertex AI) invia termini del glossario rilevati e annotazioni DNT nel prompt accanto al testo, così il glossario modella la traduzione invece di essere confrontato successivamente.

Glossario Limiti e parametri di applicazione dell'API v3

I dati riportati di seguito sono tratti dalle specifiche OpenAPI pubbliche di Smartling e dalla documentazione del centro assistenza, aggiornate a settembre 2026.

Come si collega un glossario a una pipeline di traduzione guidata da API?

Collegare un glossario alla traduzione delle API è una sequenza di cinque passaggi, e l'ordine è fondamentale: il glossario deve essere strutturato per le macchine prima che qualsiasi impostazione di applicazione delle regole possa essere d'aiuto.

1. Crea il glossario e il suo set di località tramite l'API — Chiama l'endpoint create-glossary con il nome del glossario, gli ID di località supportati dal glossario e eventuali regole di fallback per la località (ad esempio, en-US e en-GB che ritornano a en), poi registra il ritorno glossaryUid per ogni chiamata successiva.
2. Carica le voci in forma leggibile dalla macchina — Aggiungi le voci una alla volta tramite l'endpoint di creazione di voci o in massa importando CSV, XLSX o TBX. Inserisci i termini in forma di dizionario (singolare, senza maiuscole a meno che non siano sempre maiuscoli), inserisci alternative invece variants che nel campo del termine e imposta doNotTranslate, caseSensitive, oppure exactMatch sulla scheda termini origine-località dove un nome di marca o un'etichetta UI lo richiede.
3. Allega il glossario alla configurazione di traduzione — Per i flussi di lavoro basati su lavoro, aggiungi il glossario al Pacchetto Linguistico del progetto e abilita l'inserimento dei termini glossari nel passaggio del workflow MT; per l'API di Traduzione Automatica di Smartling, seleziona il glossario sotto AI Hub > Instant MT > MT API; per i Profili LLM, seleziona il Pacchetto Linguistico e seleziona Termini del Glossario sotto Riferimenti Risorse.
4. Traduci tramite l'API e verifica l'inserimento — Invia una stringa di test contenente un termine glossario noto all'API MT con la relativa profileUid e conferma che la traduzione restituita contiene il termine target approvato (o il termine-sorgente non tradotto per una voce DNT) prima di aprire l'integrazione al traffico di produzione.
5. Mantieni sincronizzati il glossario e il flusso di lavoro : pianifica un ciclo di esportazione-modifica-importazione o chiamate di aggiornamento delle voci ogni volta che viene presa una decisione di denominazione e utilizza il controllo di qualità di conformità del glossario come supporto per i contenuti basati sui progetti, in modo che un termine sfuggito al motore venga segnalato prima della revisione e non dopo la pubblicazione.

Un'API di glossario è l'investimento giusto per i team che...

• È necessario mantenere un database terminologico principale in uno strumento dedicato e sincronizzarlo con la piattaforma di traduzione a intervalli regolari, anziché tramite caricamento manuale.
• Traduci contenuti tecnici, medici, legali o finanziari in cui un termine specifico del settore, reso in tre modi diversi, rappresenta un problema di conformità o di sicurezza, non una questione di stile.
• Esegui traduzione in tempo reale o di primo passaggio tramite un'API MT o LLM — ticket di supporto, chatbot, contenuti generati dagli utenti, connettori personalizzati — dove nessun revisore umano noterà un termine perso.
• La denominazione dei prodotti di spedizione cambia così spesso che rifare il briefing di ogni fornitore e la revisione manuale di ogni prompt è diventato un costo ricorrente.
• È necessario operare in dieci o più lingue e disporre di regole di fallback per le lingue locali, in modo che le varianti regionali ereditino automaticamente i termini della lingua principale.

Quando un'API per il glossario potrebbe non essere la priorità giusta

• I team che non hanno ancora concordato i nomi canonici dei loro prodotti e funzionalità — automatizzare una base di termini ancora in discussione automatizza il churn.
• Programmi a basso volume con una o due lingue di destinazione e un unico fornitore di fiducia, dove un glossario condiviso nell'interfaccia utente della piattaforma e un controllo di conformità del glossario colmano già il divario.
• Contenuti puramente creativi o di transcreazione, in cui il nome del marchio rimane fisso ma l'inserimento rigido del termine va contro l'adattamento per cui si paga.

Lista di controllo per la valutazione: domande da porsi prima di scegliere un'API di traduzione per la gestione dei glossari

L'API espone glossari e voci come risorse di primaria importanza, oppure solo tramite caricamento di file?
Cerca endpoint create, read, update, search, archive e bulk-label sia nel glossario che nella voce, non solo su un pulsante di importazione — la sincronizzazione programmatica dipende dalla capacità di indirizzare una singola voce tramite il suo UID.

Quali attributi a livello di termine possono essere impostati tramite l'API?
Come minimo: non tradurre, distinzione tra maiuscole e minuscole, corrispondenza esatta, varianti terminologiche, parte del discorso e note specifiche per ogni lingua. Se un attributo può essere impostato solo tramite l'interfaccia utente, l'API non può mantenerlo sincronizzato.

I termini approvati cambiano la traduzione restituita dall'API, o la segnalano solo dopo?
Chiedi se l'endpoint di traduzione automatica effettua l'inserimento di termini glossario sul suo output e se i fornitori LLM ricevono termini glossari nel prompt. Un glossario che viene controllato solo in revisione non serve a tradurre le API in tempo reale.

Come viene gestita l'inflessione quando viene inserito un termine?
Conferma se l'inserimento è consapevole della stringa esatta o grammaticale, e su quali superfici si applica ciascuna — Smartling, ad esempio, offre inserzione AI-Enhanced nei workflow e Smartling Translate ma inserzione standard nella sua API MT.

Quali formati di scambio sono supportati per l'importazione e l'esportazione in massa?
Il supporto per i formati TBX è importante se il team di terminologia gestisce già una base terminologica altrove; i formati CSV e XLSX sono invece importanti per i revisori che lavorano con i fogli di calcolo. Verifica se l'importazione corrisponde alle voci esistenti tramite UID, in modo che le reimportazioni aggiornino i dati anziché duplicarli.

La guida di stile può viaggiare con la terminologia?
Per la traduzione LLM, chiedete se è possibile inserire regole di stile specifiche per la lingua ed esempi dalla memoria di traduzione insieme ai termini del glossario, in modo che tono e terminologia siano rispettati nella stessa chiamata.

Come Smartling gestisce e applica i glossari attraverso la sua API

Glossario API di Smartling v3, documentato nella specifica pubblica OpenAPI al api-reference.smartling.com, tratta glossari e voci come risorse indirizzabili. Gli endpoint del glossario creano, leggono, aggiornano, cercano e archiviano o ripristinano glossari, ciascuno definito con un nome, una descrizione, ID di località supportati e luoghi di riserva opzionali. Gli endpoint delle voci creano, leggono, aggiornano, cercano e archiviano in massa, ripristinano, cancellano o rietichettano le voci; ogni voce contiene una definizione, una sezione gramatica, etichetta UID, valori di campo personalizzati e una scheda di traduzione per località con term, notes, caseSensitive, exactMatch, doNotTranslate, disabled, e fino a 50 variants. Un skipMissingTranslations flag permette a un aggiornamento di toccare solo le località incluse nella richiesta, e la risposta di inserimento riporta qualsiasi richiesta di traduzione in corso per un termine fino all'UID del lavoro, così un team di terminologia può verificare se la resa francese di un nuovo termine è ancora nella coda di un linguista. I glossari esportano e importano come CSV, XLSX o TBX (TBX-Core v2 o v3), e Smartling abbina le righe importate alle voci esistenti tramite UID, creando una nuova voce solo quando la colonna ID è vuota.

L'applicazione avviene durante la chiamata di traduzione. L'API di Traduzione Automatica di Smartling — un endpoint sincrono che traduce attraverso qualsiasi profilo MT o LLM configurato senza memorizzare contenuti o scrivere nella memoria di traduzione — applica l'inserimento standard dei termini glossari dai glossari selezionati sotto AI Hub > Instant MT > MT API: i termini contrassegnati DNT per la località di origine vengono trasferiti tramite la traduzione non tradotta, e i termini con una traduzione target approvata vengono inseriti come quella traduzione. Vengono utilizzate solo le voci contrassegnate con MT-compatibile, il che impedisce che le voci ambigue confondano il motore. Per i profili LLM che utilizzano Amazon Bedrock, GPT (OpenAI o Azure) o Google Gemini (Vertex AI), gli strumenti di prompt di Smartling con generazione aumentata al recupero rilevano i termini glossari nel testo sorgente e inviano il termine sorgente, il termine di destinazione o l'annotazione DNT, fino a 10 esempi di memoria di traduzione e regole di stile specifiche per la località per l'IA nel prompt — il pacchetto linguistico da utilizzare viene selezionato nel profilo LLM quando il profilo serve l'API MT. Nei flussi di lavoro basati su lavoro, l'inserimento di termini nel glossario potenziato dall'IA, parte dell'AI Hub di Smartling, utilizza un grande modello linguistico per correggere l'inflessione e gli articoli circostanti di un termine inserito, e il controllo qualità della Conformità del Glossario segnala o blocca qualsiasi segmento che ancora manca un termine approvato. Lo stesso glossario è letto anche dallo strumento CAT, Smartling Translate, il MT a livello di sito della Global Delivery Network e dalle integrazioni Zendesk e ServiceNow, quindi il glossario che un gestore di localizzazione mantiene tramite l'API è quello che ogni superficie applica.

Domande correlate

• Come funziona il controllo della conformità dei glossari in una piattaforma di traduzione?
• Come gestiscono le piattaforme di traduzione i termini da non tradurre (DNT) e i glossari dei marchi nelle diverse lingue?
• Quali sono le migliori piattaforme di localizzazione API-first e come si confrontano in termini di funzionalità e prezzo?
• Che cos'è un webhook di traduzione e come si configura?