# General Translation Knowledge Base: Cosa fa l'agente Locadex? URL: https://generaltranslation.com/it/kb/what-is-locadex.mdx Docs index: https://generaltranslation.com/llms.txt Description: Locadex è l'agente IA di General Translation che internazionalizza il codice e traduce i contenuti nel tuo repository GitHub. Le sue automazioni vengono eseguite all'apertura di una pull request, al push di un commit o quando le avvii tu, e ogni modifica arriva sotto forma di pull request. Category: Strumenti per il flusso di lavoro Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Locadex è l'agente IA di General Translation che internazionalizza il codice e traduce i contenuti nel tuo repository GitHub, consegnando ogni modifica come pull request. In un'app disponibile in più lingue, ogni nuovo testo dell'interfaccia deve essere racchiuso in chiamate di internazionalizzazione (i18n) e tradotto in ciascuna lingua di destinazione, mentre aggiungere o rimuovere una lingua richiede di aggiornare la configurazione. Se svolto a mano, questo lavoro arriva dopo le modifiche al codice: una funzionalità viene quindi rilasciata prima nella lingua di origine e le traduzioni seguono solo in un secondo momento. | Approccio | Punti di forza | Quando avviene la traduzione | Cosa resta a tuo carico | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | Solo una libreria i18n (`i18next`, `react-intl`, `next-intl`) | Runtime maturi per renderizzare le traduzioni e formattare i valori | Ogni volta che qualcuno aggiorna i file di lingua | Sostituire ogni stringa con una chiave, aggiungerla a ogni file di lingua ed eseguire tu stesso il commit delle modifiche | | Un agente di programmazione che guidi tu, come Cursor o Claude Code con il [prompt iniziale](/docs/overview/for-coding-agents#start-prompt) di General Translation | Configura l'i18n in una sessione sotto la tua supervisione | Quando tu o la tua CI eseguite [`npx gt translate`](/docs/cli/reference/commands/translate) | Supervisionare la sessione, quindi rivedere le modifiche ed eseguirne il commit | | General Translation (Locadex) | La sua automazione **Generate code** racchiude il testo in chiamate i18n a ogni esecuzione, e ogni modifica arriva come pull request | In base al trigger che scegli: una pull request, un push o **Run now** | Rivedere ogni pull request, oppure attivare **Auto-merge** | Usa solo una libreria i18n quando i file di lingua sono gestiti dai traduttori e ogni rilascio può aspettare il loro lavoro. Usa un agente di programmazione per una configurazione una tantum che vuoi seguire da vicino, poi esegui [`npx gt translate`](/docs/cli/reference/commands/translate) in CI prima di ogni build. Usa Locadex quando l'app o la documentazione cambiano con quasi ogni pull request e vuoi ricevere le traduzioni di ogni modifica in una pull request, senza dover mantenere un passaggio nella pipeline. Per uno stack non incluso nell'elenco di Locadex, come Vue o Node.js, usa le librerie di General Translation e la CLI `gt`. ## Video The video is narrated in English, with English captions. [What does the Locadex agent do?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-what-is-locadex.mp4) (49 s) General Translation uses its AI agent Locadex to open pull requests that translate your app. Connect GitHub in the Dashboard and create an automation from a template: Generate code wraps untranslated text in the right i18n calls, Generate translations and push translates each change into every target language, and Keep locales in sync updates the project when languages change. Run setup with your target languages, merge its pull request, and review Locadex's pull requests or turn on auto-merge. ## Cosa automatizza Locadex I team possono configurare quando viene eseguita ciascuna automazione di Locadex, quali modifiche apporta e in che modo vengono distribuite su GitHub. Ogni automazione parte da uno dei tre modelli disponibili in **Project > Automations**: * **Generate code** individua il testo dell'interfaccia non tradotto e lo racchiude in chiamate i18n, come il componente [``](/docs/react/reference/components/t). * **Generate translations and push** traduce il contenuto di origine nuovo o aggiornato in tutte le lingue di destinazione. * **Keep locales in sync** aggiorna i file del progetto quando vengono aggiunte o rimosse lingue. Locadex supporta Next.js, le app React realizzate con Vite, Gatsby, Redwood, React Router, TanStack Start (la relativa libreria `gt-tanstack-start` è sperimentale) e altri ancora, oltre ai framework per la documentazione Mintlify, Fern e Docusaurus. ## Come funziona Locadex richiede un piano Starter o Enterprise e le sue esecuzioni vengono conteggiate in Locadex Compute Unit (LCU); le tariffe aggiornate sono disponibili nella [pagina dei prezzi](https://generaltranslation.com/pricing). Collega GitHub da **Project > Integrations > Catalog**, crea un'automazione e fai clic su **Run setup** per scegliere il locale di origine e le lingue di destinazione, ad esempio dall'inglese verso spagnolo, francese e giapponese. In un'app React, la configurazione apre una pull request che imposta il caricamento delle traduzioni senza toccare le tue stringhe. Dopo averne eseguito il merge, **Generate code** le racchiude in chiamate come [``](/docs/react/reference/components/t), che in una pagina Next.js appare così: ```tsx title="app/page.tsx" import { T } from 'gt-next'; export default function Home() { return (

Welcome to my app

This content will be translated automatically.
); } ``` **Run when** imposta il trigger di ciascuna automazione. Con **A pull request changes**, Locadex si avvia quando una pull request viene aperta, riaperta o contrassegnata come pronta per la revisione, quindi apre una pull request separata e ne inserisce il link in un commento sulla tua. Con **A commit is pushed**, si avvia quando i commit arrivano sul branch di destinazione, di solito `main`. Con **Started manually**, si avvia solo quando fai clic su **Run now**. **Auto-merge** è disattivato per impostazione predefinita; se attivato, esegue il merge delle pull request di Locadex quando i controlli vengono superati. Le traduzioni di Locadex seguono i [gruppi di contesto](/docs/platform/dashboard/guides/defining-context-for-translations) assegnati al tuo progetto General Translation (un Glossario che fissa i termini di prodotto e prompt personalizzati che definiscono il tono). Le modifiche apportate nella dashboard arrivano su GitHub allo stesso modo: alla successiva esecuzione di traduzione, Locadex include le modifiche della dashboard in una pull request. ## Configurare il repository Usa i [comandi di pre-elaborazione](/docs/platform/locadex/guides/configuring-automations) per installare le dipendenze e gli strumenti necessari al tuo progetto nella [sandbox di Locadex](/docs/platform/locadex/reference/vm-image). In un monorepo, imposta **Target directory** sulla cartella dell'app e fai iniziare i comandi di pre-elaborazione con un `cd` in quella cartella. Esamina manualmente le pull request di configurazione. Per le pull request generate in seguito dalle automazioni, **Auto-merge** richiede che i controlli vengano superati e che il repository disponga delle autorizzazioni descritte in [Configurare le automazioni](/docs/platform/locadex/guides/configuring-automations). Per richiedere un'esecuzione sulla revisione corrente di una pull request, commenta `/locadex`. La guida alle automazioni descrive il comportamento dei trigger e le impostazioni del repository, mentre l'[Avvio rapido di Locadex](/docs/platform/locadex/quickstart) riporta tutti i passaggi. ## Related questions - [Come si internazionalizza un'app con Cursor o Claude Code?](https://generaltranslation.com/it/kb/ai-agent-i18n-setup.mdx): Inizia con il prompt Setup for Agents di General Translation in Cursor o Claude Code, scegli una funzionalità e le lingue di destinazione, poi lascia che sia l'agente a implementare e verificare il risultato. L'accesso tramite browser, la documentazione leggibile dalle macchine e gli strumenti MCP collegano la configurazione alla traduzione e alla revisione. Usa Locadex per automatizzare la localizzazione continua tramite pull request. - [Come si aggiunge l'i18n a un'app Next.js con App Router?](https://generaltranslation.com/it/kb/add-i18n-to-nextjs.mdx): Inizia con gt init per configurare General Translation in un progetto App Router supportato, poi contrassegna il contenuto di origine, genera le traduzioni e verifica il cambio di lingua. gt-next mantiene i testi nel JSX insieme al contesto di traduzione; la CLI, l'editor della Dashboard e Locadex si occupano di generazione, revisione e aggiornamenti continui. Questa guida mostra anche la configurazione esplicita con file locali. - [Come si traduce un sito di documentazione Mintlify?](https://generaltranslation.com/it/kb/translate-mintlify-docs.mdx): Scrivi una copia tradotta di ogni pagina in una cartella per ciascuna lingua e aggiungi ogni lingua alla navigazione di docs.json. L'agente IA di General Translation, Locadex, apre una pull request che aggiunge le pagine tradotte e la navigazione per ciascuna lingua, e poi traduce le modifiche successive. - [Come mantengo le traduzioni aggiornate a ogni distribuzione?](https://generaltranslation.com/it/kb/translations-in-ci.mdx): Esegui la traduzione come passaggio della pipeline prima di ogni build di produzione, così i nuovi testi vengono rilasciati già tradotti insieme alla distribuzione che li introduce. La CLI gt di General Translation lo fa con npx gt translate, usando una chiave API e un ID progetto archiviati come segreti CI. - [Posso fare i18n senza file di traduzione?](https://generaltranslation.com/it/kb/i18n-without-translation-files.mdx): Sì. Le librerie gt-react e gt-next di General Translation gestiscono l'i18n in React e Next.js senza chiavi di traduzione e senza dover mantenere un file JSON per ogni lingua. I testi restano inline nel JSX all'interno del componente `` e il comando gt translate genera le traduzioni per ogni lingua durante la build, sfruttando il contesto del tuo codice. Locadex può mantenerle aggiornate tramite pull request. ## Previous and next questions - Previous question: [Come si traducono le stringhe al di fuori di JSX?](https://generaltranslation.com/it/kb/translate-strings-outside-jsx.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/it/kb/sitemap.md) for every article.