# General Translation Knowledge Base: Que fait l’agent Locadex ? URL: https://generaltranslation.com/fr/kb/what-is-locadex.mdx Docs index: https://generaltranslation.com/llms.txt Description: Locadex est l’agent IA de General Translation qui internationalise votre code et traduit votre contenu dans votre dépôt GitHub. Ses automatisations s’exécutent à l’ouverture d’une pull request, lors du push d’un commit ou lorsque vous les lancez vous-même, et chaque modification arrive sous forme de pull request. Category: Outils de workflow Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Locadex est l’agent IA de General Translation qui internationalise votre code et traduit votre contenu dans votre dépôt GitHub, puis livre chaque modification sous forme de pull request. Dans une application multilingue, tout nouveau texte d’interface doit être encapsulé dans des appels d’internationalisation (i18n) et traduit dans chaque langue cible, et l’ajout ou la suppression d’une langue implique de mettre à jour la configuration. Fait à la main, ce travail intervient après les modifications du code : une fonctionnalité sort donc d’abord dans la langue source, et ses traductions arrivent plus tard. | Approche | Points forts | Moment de la traduction | Ce qui reste à votre charge | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Une bibliothèque d’i18n seule (`i18next`, `react-intl`, `next-intl`) | Des environnements d’exécution éprouvés pour afficher les traductions et formater les valeurs | Chaque fois que quelqu’un met à jour les fichiers de langue | Remplacer chaque chaîne de caractères par une clé, l’ajouter à chaque fichier de langue et committer vous-même les modifications | | Un agent de codage que vous pilotez, comme Cursor ou Claude Code avec le [prompt de démarrage](/docs/overview/for-coding-agents#start-prompt) de General Translation | Met en place l’i18n dans une session que vous supervisez | Lorsque vous ou votre CI exécutez [`npx gt translate`](/docs/cli/reference/commands/translate) | Superviser la session, puis relire et committer ses modifications | | General Translation (Locadex) | Son automatisation **Generate code** encapsule le texte dans des appels i18n à chaque exécution, et chaque modification arrive sous forme de pull request | Selon le déclencheur choisi : une pull request, un push ou **Run now** | Relire chaque pull request, ou activer **Auto-merge** | Optez pour une bibliothèque d’i18n seule lorsque les traducteurs gèrent les fichiers de langue et que chaque livraison peut attendre leur travail. Optez pour un agent de codage pour une configuration initiale ponctuelle que vous souhaitez superviser, puis exécutez [`npx gt translate`](/docs/cli/reference/commands/translate) dans votre CI avant chaque compilation. Optez pour Locadex lorsque l’application ou la documentation évolue avec la plupart des pull requests et que vous souhaitez recevoir les traductions de chaque modification dans une pull request, sans maintenir d’étape de pipeline. Pour une stack absente de la liste prise en charge par Locadex, comme Vue ou Node.js, utilisez les bibliothèques de General Translation et 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. ## Ce que Locadex automatise Les équipes définissent quand chaque automatisation Locadex s'exécute, ce qu'elle modifie et comment les modifications sont livrées dans GitHub. Chaque automatisation repose sur l'un des trois modèles proposés dans **Project > Automations** : * **Generate code** détecte le texte d'interface non traduit et l'encapsule dans des appels i18n, comme le composant [``](/docs/react/reference/components/t). * **Generate translations and push** traduit le contenu source nouveau ou modifié dans chaque langue cible. * **Keep locales in sync** met à jour les fichiers du projet lorsque des langues sont ajoutées ou supprimées. Locadex prend en charge Next.js ; les applications React créées avec Vite, Gatsby, Redwood, React Router, TanStack Start (sa bibliothèque `gt-tanstack-start` est expérimentale), entre autres ; ainsi que les frameworks de documentation Mintlify, Fern et Docusaurus. ## Fonctionnement Locadex nécessite un plan Starter ou Enterprise, et ses exécutions sont décomptées en unités de calcul Locadex (LCU) ; consultez la [page des tarifs](https://generaltranslation.com/pricing) pour connaître les prix en vigueur. Connectez GitHub dans **Project > Integrations > Catalog**, créez une automatisation, puis cliquez sur **Run setup** pour choisir le paramètre régional source et les langues cibles, par exemple de l'anglais vers l'espagnol, le français et le japonais. Dans une application React, la configuration initiale ouvre une pull request qui configure le chargement des traductions sans toucher à vos chaînes. Une fois la pull request fusionnée, **Generate code** encapsule ces chaînes dans des appels tels que [``](/docs/react/reference/components/t), ce qui donne, dans une page Next.js : ```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** définit le déclencheur de chaque automatisation. Avec **A pull request changes**, Locadex s'exécute lorsqu'une pull request est ouverte, rouverte ou marquée comme prête pour la revue, puis ouvre une pull request distincte et y renvoie dans un commentaire sur la vôtre. Avec **A commit is pushed**, il s'exécute lorsque des commits sont poussés sur la branche cible, généralement `main`. Avec **Started manually**, il ne s'exécute que lorsque vous cliquez sur **Run now**. L'**auto-merge** est désactivé par défaut ; une fois activé, il fusionne les pull requests de Locadex dès que les vérifications réussissent. Les traductions de Locadex respectent les [groupes de contexte](/docs/platform/dashboard/guides/defining-context-for-translations) assignés à votre projet General Translation (un glossaire qui fixe la terminologie produit et des instructions personnalisées qui définissent le ton). Les modifications effectuées dans le tableau de bord sont répercutées sur GitHub de la même manière : la prochaine exécution de traduction de Locadex les intègre dans une pull request. ## Configurer le dépôt Utilisez les [commandes de prétraitement](/docs/platform/locadex/guides/configuring-automations) pour installer les dépendances et les outils nécessaires à votre projet dans le [bac à sable Locadex](/docs/platform/locadex/reference/vm-image). Dans un monorepo, définissez **Target directory** sur le dossier de l'application et commencez vos commandes de prétraitement par un `cd` vers ce dossier. Examinez manuellement les pull requests de configuration initiale. Pour les pull requests d'automatisation suivantes, l'**Auto-merge** exige que les vérifications soient réussies et que le dépôt dispose des autorisations décrites dans [Configurer les automatisations](/docs/platform/locadex/guides/configuring-automations). Pour lancer une exécution sur la révision actuelle d'une pull request, commentez `/locadex`. Le guide des automatisations détaille le fonctionnement des déclencheurs et les paramètres du dépôt, et le [Démarrage rapide Locadex](/docs/platform/locadex/quickstart) présente toutes les étapes. ## Related questions - [Comment internationaliser une application avec Cursor ou Claude Code ?](https://generaltranslation.com/fr/kb/ai-agent-i18n-setup.mdx): Commencez par le prompt Setup for Agents de General Translation dans Cursor ou Claude Code, choisissez une fonctionnalité et des langues cibles, puis laissez l’agent implémenter et vérifier le résultat. La connexion via le navigateur, la documentation lisible par machine et les outils MCP font le lien entre la configuration initiale, la traduction et la relecture. Utilisez Locadex pour automatiser la localisation continue au moyen de pull requests. - [Comment ajouter l’i18n à une application Next.js App Router ?](https://generaltranslation.com/fr/kb/add-i18n-to-nextjs.mdx): Commencez par gt init pour configurer General Translation dans un projet App Router pris en charge, puis balisez le contenu source, générez les traductions et vérifiez le changement de langue. gt-next conserve les textes dans le JSX avec leur contexte de traduction ; la CLI, l’éditeur du tableau de bord et Locadex prennent en charge la génération, la relecture et les mises à jour continues. Ce guide présente également la configuration initiale explicite avec des fichiers locaux. - [Comment traduire un site de documentation Mintlify ?](https://generaltranslation.com/fr/kb/translate-mintlify-docs.mdx): Rédigez une copie traduite de chaque page dans un dossier par langue, puis ajoutez chaque langue à la navigation de docs.json. Locadex, l’agent IA de General Translation, ouvre une pull request qui ajoute les pages traduites et la navigation propre à chaque langue, puis traduit les modifications ultérieures. - [Comment maintenir les traductions à jour à chaque déploiement ?](https://generaltranslation.com/fr/kb/translations-in-ci.mdx): Exécutez la traduction comme une étape du pipeline avant chaque compilation de production, afin que les nouveaux textes soient livrés traduits avec le déploiement qui les ajoute. Le CLI gt de General Translation s’en charge avec npx gt translate, à l’aide d’une clé API de projet et d’un identifiant de projet stockés comme secrets CI. - [Peut-on faire de l’i18n sans fichiers de traduction ?](https://generaltranslation.com/fr/kb/i18n-without-translation-files.mdx): Oui. Les bibliothèques gt-react et gt-next de General Translation permettent d’internationaliser React et Next.js sans clés de traduction ni fichier JSON par langue à maintenir. Le texte reste intégré au JSX, dans le composant ``, et la commande gt translate génère les traductions de chaque langue lors de la compilation, en s’appuyant sur le contexte de votre code. Locadex peut les tenir à jour via des pull requests. ## Previous and next questions - Previous question: [Comment traduire une application Vue ?](https://generaltranslation.com/fr/kb/translate-vue-app.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/fr/kb/sitemap.md) for every article.