# General Translation Knowledge Base: Что делает агент Locadex? URL: https://generaltranslation.com/ru/kb/what-is-locadex.mdx Docs index: https://generaltranslation.com/llms.txt Description: Locadex — это AI-агент General Translation, который интернационализирует ваш код и переводит контент в вашем репозитории GitHub. Его автоматизации запускаются при открытии пул-реквеста, при пуше коммита или вручную, а каждое изменение поступает в виде пул-реквеста. Category: Инструменты для рабочих процессов Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Locadex — это AI-агент General Translation, который интернационализирует ваш код и переводит контент в вашем репозитории GitHub, а каждое изменение оформляет в виде пул-реквеста. В многоязычном приложении новый текст интерфейса нужно обернуть в вызовы интернационализации (i18n) и перевести на каждый язык перевода, а при добавлении или удалении языка приходится обновлять конфигурацию. Если делать это вручную, работа выполняется уже после изменения кода, поэтому функция сначала выходит на языке-источнике, а переводы появляются позже. | Подход | Сильные стороны | Когда выполняется перевод | Что остаётся на вас | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Только библиотека интернационализации (`i18next`, `react-intl`, `next-intl`) | Зрелые среды выполнения для рендеринга переводов и форматирования значений | Когда кто-то обновляет языковые файлы | Замена каждой строки ключом, добавление её во все языковые файлы и коммит изменений вручную | | Агент для написания кода под вашим управлением, например Cursor или Claude Code со [стартовым промптом](/docs/overview/for-coding-agents#start-prompt) General Translation | Настраивает i18n в сессии под вашим контролем | Когда вы или ваш CI запускаете [`npx gt translate`](/docs/cli/reference/commands/translate) | Контроль сессии, затем проверка и коммит внесённых правок | | General Translation (Locadex) | Автоматизация **Generate code** оборачивает текст в вызовы i18n при каждом запуске, а каждое изменение поступает в виде пул-реквеста | По выбранному триггеру: пул-реквест, пуш или **Run now** | Проверка каждого пул-реквеста или включение **Auto-merge** | Выбирайте только библиотеку интернационализации, если языковыми файлами занимаются переводчики и каждый релиз может их подождать. Агент для написания кода подойдёт для разовой настройки, которую вы хотите контролировать; после неё запускайте [`npx gt translate`](/docs/cli/reference/commands/translate) в CI перед каждой сборкой. Locadex стоит выбрать, если приложение или документация меняются почти в каждом пул-реквесте и вы хотите получать переводы каждого изменения в пул-реквесте, не поддерживая отдельный шаг конвейера. Если вашего стека нет в списке Locadex (например, Vue или Node.js), используйте библиотеки General Translation и 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 с) 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. ## Что автоматизирует Locadex Команды сами настраивают, когда запускается каждая автоматизация Locadex, что она изменяет и как изменения доставляются в GitHub. Каждая автоматизация создаётся на основе одного из трёх шаблонов в разделе **Project > Automations**: * **Generate code** находит непереведённый текст интерфейса и оборачивает его в вызовы i18n, например в компонент [``](/docs/react/reference/components/t). * **Generate translations and push** переводит новое или обновлённое исходное содержимое на все целевые языки. * **Keep locales in sync** обновляет файлы проекта при добавлении или удалении языков. Locadex поддерживает Next.js; React-приложения на Vite, Gatsby, Redwood, React Router, TanStack Start (библиотека `gt-tanstack-start` для него пока экспериментальная) и других инструментах; а также фреймворки для документации Mintlify, Fern и Docusaurus. ## Как это работает Для работы Locadex нужен тариф Starter или Enterprise, а его запуски тарифицируются в вычислительных единицах Locadex (LCU); актуальные расценки указаны на [странице с ценами](https://generaltranslation.com/pricing). Подключите GitHub в разделе **Project > Integrations > Catalog**, создайте автоматизацию и нажмите **Run setup**, чтобы выбрать исходную локаль и целевые языки — например, перевод с английского на испанский, французский и японский. В React-приложении на этапе настройки открывается пул-реквест, который настраивает загрузку переводов, не затрагивая ваши строки. После его слияния **Generate code** оборачивает строки в вызовы вроде [``](/docs/react/reference/components/t). На странице 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** задаёт триггер для каждой автоматизации. При значении **A pull request changes** Locadex запускается, когда пул-реквест открывают, переоткрывают или помечают как готовый к ревью, после чего создаёт отдельный пул-реквест и оставляет ссылку на него в комментарии к вашему. При значении **A commit is pushed** запуск происходит, когда коммиты попадают в целевую ветку (обычно `main`). При значении **Started manually** Locadex запускается только по нажатию **Run now**. **Auto-merge** по умолчанию отключён. Если его включить, Locadex будет выполнять слияние своих пул-реквестов после успешного прохождения проверок. При переводе Locadex учитывает [контекстные группы](/docs/platform/dashboard/guides/defining-context-for-translations), назначенные вашему проекту General Translation (Glossary, закрепляющий термины продукта, и пользовательские промпты, задающие тон). Правки, внесённые в панели управления, попадают в GitHub тем же путём: при следующем запуске перевода Locadex переносит их в пул-реквест. ## Настройка репозитория С помощью [команд предварительной обработки](/docs/platform/locadex/guides/configuring-automations) установите в [песочнице Locadex](/docs/platform/locadex/reference/vm-image) зависимости и инструменты, необходимые вашему проекту. В монорепозитории укажите в поле **Target directory** папку приложения, а команды предварительной обработки начинайте с перехода в неё через `cd`. Пул-реквесты настройки проверяйте вручную. Для последующих пул-реквестов автоматизации **Auto-merge** срабатывает только при успешном прохождении проверок и наличии разрешений репозитория, описанных в разделе [Настройка автоматизаций](/docs/platform/locadex/guides/configuring-automations). Чтобы запросить запуск для текущей ревизии пул-реквеста, оставьте комментарий `/locadex`. Поведение триггеров и настройки репозитория описаны в руководстве по автоматизации, а пошаговые инструкции приведены в разделе [Быстрый старт Locadex](/docs/platform/locadex/quickstart). ## Related questions - [Как интернационализировать приложение с помощью Cursor или Claude Code?](https://generaltranslation.com/ru/kb/ai-agent-i18n-setup.mdx): Начните с промпта Setup for Agents от General Translation в Cursor или Claude Code, выберите функциональность и целевые языки, а затем поручите агенту реализовать и проверить результат. Вход через браузер, машиночитаемая документация и инструменты MCP связывают настройку с переводом и проверкой. Используйте Locadex, чтобы автоматизировать дальнейшую локализацию через пул-реквесты. - [Как добавить i18n в приложение Next.js на App Router?](https://generaltranslation.com/ru/kb/add-i18n-to-nextjs.mdx): Начните с gt init, чтобы настроить General Translation в поддерживаемом проекте на App Router, затем разметьте исходное содержимое, создайте переводы и проверьте переключение языка. gt-next хранит тексты прямо в JSX вместе с контекстом перевода, а CLI, редактор в панели управления и Locadex берут на себя генерацию, проверку и последующие обновления. В этом руководстве также показана явная настройка с локальными файлами. - [Как перевести сайт документации на Mintlify?](https://generaltranslation.com/ru/kb/translate-mintlify-docs.mdx): Создайте переведённую копию каждой страницы в отдельной папке для каждого языка и добавьте все языки в навигацию docs.json. AI-агент General Translation под названием Locadex открывает пул-реквест, который добавляет переведённые страницы и навигацию для каждого языка, а затем переводит последующие изменения. - [Как поддерживать переводы в актуальном состоянии при каждом развёртывании?](https://generaltranslation.com/ru/kb/translations-in-ci.mdx): Запускайте перевод как этап конвейера перед каждой сборкой для рабочей среды — тогда новые тексты попадут в то же развёртывание, что и сами изменения, уже переведёнными. В CLI gt от General Translation для этого служит команда npx gt translate, которая использует ключ API проекта и идентификатор проекта, сохранённые как секреты CI. - [Можно ли делать i18n без файлов перевода?](https://generaltranslation.com/ru/kb/i18n-without-translation-files.mdx): Да. Библиотеки gt-react и gt-next от General Translation обеспечивают i18n для React и Next.js без ключей перевода и без отдельного JSON-файла для каждого языка, который приходится поддерживать. Тексты остаются встроенными в JSX внутри компонента ``, а команда gt translate генерирует переводы для каждого языка во время сборки, учитывая контекст из вашего кода. Locadex может поддерживать их в актуальном состоянии через пул-реквесты. ## Previous and next questions - Previous question: [Как форматировать числа, даты и валюты для каждой локали?](https://generaltranslation.com/ru/kb/format-numbers-dates-currencies.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/ru/kb/sitemap.md) for every article.