# General Translation Knowledge Base: Locadex エージェントは何をするのか？ URL: https://generaltranslation.com/ja/kb/what-is-locadex.mdx Docs index: https://generaltranslation.com/llms.txt Description: Locadex は General Translation の AI エージェントで、GitHub リポジトリ内のコードを国際化し、コンテンツを翻訳します。自動化はプルリクエストの作成時、コミットのプッシュ時、または手動で開始したときに実行され、すべての変更はプルリクエストとして届きます。 Category: ワークフローツール Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Locadex は General Translation の AI エージェントで、GitHub リポジトリ内のコードを国際化し、コンテンツを翻訳して、すべての変更をプルリクエストとして届けます。多言語対応のアプリでは、新しく追加した UI テキストを国際化 (i18n) の呼び出しでラップし、各対象言語に翻訳する必要があります。さらに、言語を追加・削除するたびに設定も更新しなければなりません。これを手作業で行うと、作業はコードの変更後になるため、機能はまずソース言語でリリースされ、翻訳は後追いになります。 | アプローチ | 得意なこと | 翻訳のタイミング | 自分で行う必要があること | | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------ | | i18nライブラリ単体 (`i18next`、`react-intl`、`next-intl`) | 翻訳のレンダリングと値のフォーマットを担う成熟したランタイム | 誰かが言語ファイルを更新したとき | 各文字列をキーに置き換えてすべての言語ファイルに追加し、変更を自分でコミットすること | | Cursor や Claude Code など、自分で操作するコーディングエージェント (General Translation の[スタートプロンプト](/docs/overview/for-coding-agents#start-prompt)を使用) | 自分が監督するセッション内で i18n をセットアップできる | 自分または CI が [`npx gt translate`](/docs/cli/reference/commands/translate) を実行したとき | セッションを監督し、エージェントによる編集をレビューしてコミットすること | | General Translation (Locadex) | **Generate code** 自動化が実行のたびにテキストを i18n 呼び出しでラップし、すべての変更がプルリクエストとして届く | 選択したトリガー (プルリクエスト、プッシュ、または **Run now**) の発生時 | 各プルリクエストのレビュー、または **Auto-merge** の有効化 | 翻訳者が言語ファイルを管理しており、各リリースが翻訳の完了を待てる場合は、i18nライブラリ単体で十分です。一度きりのセットアップを自分で見守りながら進めたい場合はコーディングエージェントを使い、その後は各ビルドの前に CI で [`npx gt translate`](/docs/cli/reference/commands/translate) を実行しましょう。ほとんどのプルリクエストでアプリやドキュメントに変更が入り、パイプラインのステップを保守せずに各変更の翻訳をプルリクエストで受け取りたい場合は、Locadex が最適です。Vue や Node.js など、Locadex の対応リストにないスタックでは、General Translation のライブラリと `gt` CLI を使用してください。 ## 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** にある 3 つのテンプレートのいずれかをもとに作成します。 * **Generate code** は、未翻訳のインターフェーステキストを検出し、[``](/docs/react/reference/components/t) コンポーネントなどの i18n 呼び出しでラップします。 * **Generate translations and push** は、新規または更新されたソースコンテンツをすべての対象言語に翻訳します。 * **Keep locales in sync** は、言語が追加または削除された際にプロジェクトファイルを更新します。 Locadex は、Next.js に加え、Vite、Gatsby、Redwood、React Router、TanStack Start (`gt-tanstack-start` ライブラリは実験的機能です) などで構築された React アプリ、さらにドキュメントフレームワークの Mintlify、Fern、Docusaurus に対応しています。 ## 仕組み Locadex を利用するには Starter プランまたはエンタープライズプランが必要です。実行量は Locadex Compute Unit (LCU) 単位で計測されます。最新の料金は[料金ページ](https://generaltranslation.com/pricing)をご確認ください。**Project > Integrations > Catalog** から GitHub を接続して自動化を作成し、**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** を選択すると、プルリクエストがオープン、再オープン、またはレビュー可能 (ready for review) としてマークされたときに Locadex が実行されます。Locadex は別のプルリクエストを作成し、元のプルリクエストにそのリンクをコメントします。**A commit is pushed** を選択すると、ターゲットブランチ (通常は `main`) にコミットが反映されたときに実行されます。**Started manually** を選択すると、**Run now** をクリックしたときにのみ実行されます。 **Auto-merge** はデフォルトでオフです。オンにすると、チェックに合格した時点で Locadex のプルリクエストが自動的にマージされます。 Locadex の翻訳には、General Translation プロジェクトに割り当てられた [コンテキストグループ](/docs/platform/dashboard/guides/defining-context-for-translations) (製品用語を固定する用語集と、トーンを指定するカスタムプロンプト) が適用されます。ダッシュボードで行った編集も同じ仕組みで 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/ja/kb/ai-agent-i18n-setup.mdx): Cursor または Claude Code で General Translation の Setup for Agents プロンプトを使い、機能と対象言語を選んで、エージェントに実装と検証を任せます。ブラウザでのサインイン、機械可読なドキュメント、MCP ツールにより、セットアップから翻訳、レビューまでがシームレスにつながります。継続的なローカライゼーションは、Locadex を使ってプルリクエスト経由で自動化できます。 - [Next.js App Router アプリに i18n を追加するには？](https://generaltranslation.com/ja/kb/add-i18n-to-nextjs.mdx): まず gt init を実行して、対応する App Router プロジェクトに General Translation を設定します。次にソースコンテンツをマークし、翻訳を生成して、言語の切り替えが機能することを確認します。gt-next はテキストを翻訳の文脈とともに JSX 内に保持し、生成、レビュー、継続的な更新は CLI、ダッシュボード エディター、Locadex が担います。このガイドでは、ローカルファイルを明示的に使うセットアップ方法も紹介します。 - [Mintlify のドキュメントサイトを翻訳するには？](https://generaltranslation.com/ja/kb/translate-mintlify-docs.mdx): すべてのページの翻訳版を言語ごとのフォルダーに作成し、各言語を docs.json のナビゲーションに追加します。General Translation の AIエージェントである Locadex が、翻訳済みページと言語別ナビゲーションを追加するプルリクエストを作成し、以降の変更も翻訳します。 - [デプロイのたびに翻訳を最新の状態に保つにはどうすればよいですか？](https://generaltranslation.com/ja/kb/translations-in-ci.mdx): 本番環境のビルド前に、翻訳をパイプラインのステップとして毎回実行します。こうすることで、新しいテキストは追加されたデプロイと同時に翻訳済みの状態でリリースされます。General Translation の gt CLI では、CI シークレットとして保存したプロジェクトの APIキーとプロジェクトIDを使い、npx gt translate でこれを実現します。 - [翻訳ファイルなしでi18nは実現できますか？](https://generaltranslation.com/ja/kb/i18n-without-translation-files.mdx): はい。General Translationの gt-react と gt-next ライブラリを使えば、翻訳キーも、言語ごとに管理するJSONファイルもなしで、ReactとNext.jsのi18nを実現できます。文言は `` コンポーネント内のJSXにインラインで記述したままで、gt translate コマンドがコードから得た文脈をもとに、ビルド時に各言語の翻訳を生成します。さらにLocadexを使えば、プルリクエストを通じて翻訳を常に最新の状態に保てます。 ## Previous and next questions - Previous question: [JSX の外にある文字列はどのように翻訳しますか？](https://generaltranslation.com/ja/kb/translate-strings-outside-jsx.mdx) - Next question: [Mintlify のドキュメントサイトを翻訳するには？](https://generaltranslation.com/ja/kb/translate-mintlify-docs.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/ja/kb/sitemap.md) for every article.