Strumento di Traduzione AI con Human-in-the-Loop: 23 Strumenti Agente per la Qualità della Traduzione
Un agente AI conversazionale con 23 strumenti specializzati, approvazione human-in-the-loop e rendering progressivo — gestisci le traduzioni in linguaggio naturale mantenendo il pieno controllo.
Agente di Traduzione Basato su AI in Better i18n
Better i18n va oltre la semplice traduzione AI. La dashboard include un agente AI conversazionale completo — alimentato da Google Gemini — che comprende il contesto del tuo progetto ed esegue attività di traduzione tramite linguaggio naturale. Chiedigli di tradurre un namespace, verificare le inconsistenze o aggiungere una nuova lingua, e gestirà il workflow end-to-end con la tua approvazione ad ogni passaggio.
Questo non è un approccio "genera e spera". L'agente opera con 23 strumenti specializzati, approvazione human-in-the-loop per ogni operazione di scrittura e una cache del contesto progetto di 30 secondi che lo mantiene ancorato ai tuoi dati reali.
L'Architettura dell'Agente AI
Il sistema di chat AI è costruito come un agente che utilizza strumenti, non come una semplice interfaccia domanda-risposta. Quando digiti una richiesta, l'agente:
- Legge il contesto del tuo progetto — lingue, chiavi, traduzioni, stato di sincronizzazione, modelli di contenuto
- Pianifica l'operazione — determina quali strumenti chiamare e in quale ordine
- Esegue con approvazione — le operazioni di lettura avvengono automaticamente; le operazioni di scrittura richiedono la tua conferma esplicita
- Trasmette i risultati progressivamente — le tabelle di traduzione si renderizzano in tempo reale man mano che i risultati arrivano
L'agente supporta fino a 50 passaggi per conversazione, con context stripping (slimToolResults) che previene l'overflow dei token nelle operazioni di grandi dimensioni.
23 Strumenti Specializzati
L'agente ha accesso a 23 strumenti costruiti appositamente, divisi in strumenti di lettura e strumenti di scrittura.
Strumenti di Lettura (Esecuzione Automatica)
Questi strumenti vengono eseguiti senza richiedere approvazione, dando all'agente piena visibilità sul tuo progetto:
- getTranslations — recuperare traduzioni per chiavi, namespace o lingue specifiche
- getKeyDetails — ispezionare i metadati individuali delle chiavi, note di contesto e stato della traduzione
- getLanguages — elencare tutte le lingue configurate e le loro percentuali di completamento
- getProjectStats — copertura della traduzione a livello di progetto, conteggio delle chiavi e statistiche linguistiche
- getDoctorReport — rapporto diagnostico che identifica traduzioni mancanti, chiavi inutilizzate e inconsistenze
- getSyncs — elencare tutte le integrazioni di sincronizzazione configurate (GitHub, GitLab, ecc.)
- getSyncDetails — ispezionare la configurazione e l'attività recente di una sincronizzazione specifica
- getContentModels — elencare i modelli di contenuto e le loro strutture di campo
- getContentEntries — sfogliare le voci di contenuto tra i modelli
- createPlan — generare un piano di esecuzione per operazioni complesse multi-step
Strumenti di Scrittura (Approvazione Human-in-the-Loop)
Ogni strumento di scrittura richiede la tua approvazione esplicita prima dell'esecuzione. L'agente propone modifiche, tu le rivedi, e solo allora vengono applicate:
- proposeTranslations — generare nuove traduzioni per coppie linguistiche mancanti
- proposeTranslationEdits — suggerire miglioramenti alle traduzioni esistenti
- translateBatch — tradurre in blocco le chiavi in più lingue in un'unica operazione
- proposeKeys — suggerire nuove chiavi di traduzione basate sui pattern del tuo codice
- proposeDeleteKeys — identificare e proporre la rimozione di chiavi inutilizzate o duplicate
- proposeLanguages — suggerire nuove lingue basate sulla demografia dei tuoi utenti
- proposeLanguageEdits — modificare la configurazione delle lingue (nomi visualizzati, fallback)
- publishChanges — inviare le traduzioni approvate in produzione al CDN
- proposeContentEntries — creare o aggiornare voci di contenuto CMS
- proposeContentModel — suggerire modifiche allo schema del modello di contenuto
- proposePublishEntries — mettere in coda le voci di contenuto per la pubblicazione
Human-in-the-Loop: Il Differenziatore Chiave
La maggior parte degli strumenti di traduzione AI opera con un modello "genera e spedisci". Better i18n adotta un approccio fondamentalmente diverso con l'approvazione human-in-the-loop (HITL).
Come funziona HITL in pratica:
- Chiedi all'agente: "Traduci tutte le chiavi mancanti nel namespace impostazioni in tedesco e francese"
- L'agente legge il tuo progetto, identifica 47 traduzioni mancanti e le genera
- Una proposta strutturata appare nella chat — mostrando ogni stringa sorgente, la traduzione AI e i termini del glossario applicati
- Rivedi la proposta: approva tutto, approva selettivamente o richiedi modifiche
- Solo le traduzioni approvate vengono scritte nel tuo progetto
Questo workflow garantisce che la qualità della traduzione AI soddisfi i tuoi standard prima che qualsiasi cosa raggiunga la produzione. L'agente non scrive mai dati senza il tuo consenso.
Perché è importante:
- Nessun errore silenzioso — ogni traduzione generata dall'AI viene verificata prima della messa in produzione
- Applicazione del glossario — l'AI rispetta le definizioni terminologiche, e tu lo verifichi
- Traccia di audit — ogni approvazione viene registrata con chi l'ha approvata e quando
- Reversibilità — poiché approvi ogni modifica, non ci sono batch di qualità sconosciuta in produzione
Rendering Progressivo
Quando l'agente genera traduzioni, i risultati vengono trasmessi in tempo reale nell'interfaccia della chat. La tabella di traduzione si renderizza progressivamente — vedi ogni colonna linguistica riempirsi mentre l'AI produce l'output, invece di attendere il completamento dell'intero batch.
Questo è particolarmente prezioso per le operazioni di grandi dimensioni. Quando si traducono 200 chiavi in 8 lingue, puoi iniziare a revisionare i primi risultati mentre l'agente sta ancora generando il resto.
Cronologia Chat e Persistenza
L'agente mantiene la cronologia delle conversazioni attraverso un sistema di archiviazione duale:
- IndexedDB (locale) — fornisce accesso istantaneo alle conversazioni recenti senza latenza
- Postgres (server) — mantiene una traccia di audit persistente di tutte le interazioni dell'agente
Questo significa che le tue conversazioni si caricano istantaneamente quando torni alla dashboard, pur essendo disponibili per l'audit del team e la conformità.
Esempi Pratici
Aggiungere una Nuova Lingua
Tu: "Aggiungi giapponese al progetto e traduci tutte le chiavi esistenti"
L'agente chiama getLanguages per controllare la configurazione attuale, proposeLanguages per aggiungere il giapponese, poi translateBatch per generare traduzioni per tutte le chiavi esistenti. Ogni passaggio mostra cosa sta succedendo, e le operazioni di scrittura attendono la tua approvazione.
Trovare Problemi di Traduzione
Tu: "Ci sono inconsistenze nelle traduzioni in francese?"
L'agente chiama getDoctorReport e getTranslations, poi analizza i risultati per inconsistenze terminologiche, forme plurali mancanti o chiavi non tradotte. Presenta un riepilogo con le chiavi specifiche che richiedono attenzione.
Revisione Traduzioni in Blocco
Tu: "Mostrami tutte le chiavi non tradotte nel namespace checkout per lo spagnolo"
L'agente chiama getTranslations con i filtri appropriati e presenta una tabella delle traduzioni mancanti. Puoi poi chiedergli di generare traduzioni per tutte, revisionare le proposte e approvare in blocco.
Gestione Modello e Contesto
L'agente utilizza Google Gemini come modello sottostante, selezionato per le sue forti capacità multilingue e la dimensione della finestra di contesto. Dettagli tecnici chiave:
- 50 passaggi per conversazione — sufficienti per operazioni complesse multi-step
- Context stripping — il sistema slimToolResults riduce automaticamente l'utilizzo dei token tagliando le risposte API grandi ai dati essenziali
- Cache progetto di 30 secondi — il contesto del progetto viene memorizzato nella cache per 30 secondi, prevenendo chiamate API ridondanti durante le operazioni multi-step
Come Iniziare con l'Agente AI
- Apri la dashboard Better i18n e clicca sull'icona della chat AI
- Inizia con un'operazione di lettura: "Mostrami lo stato delle traduzioni per questo progetto"
- Prova un'attività di traduzione: "Traduci tutte le chiavi mancanti nel namespace common in spagnolo"
- Rivedi le proposte dell'agente e approva o modifica secondo necessità
- Usa "Pubblica modifiche" quando sei pronto per inviare le traduzioni in produzione
L'agente AI è disponibile su tutti i piani. Crea il tuo account per provarlo con il tuo progetto.