設定リファレンス
sourceLocale
ソース言語の BCP-47 コードです (例: "en-GB"、"pt-BR"、"ja")。どの言語でも有効です。多くのプロジェクトが英語で始まるため、例では英語が使用されています。このロケール用の翻訳ファイルは生成されません。キー文字列自体がソーステキストになります。
実行時i18n設定ファイル(src/i18n.ts / src/i18n.js)からエクスポートされたSOURCE_LOCALEと一致している必要があります。
targetLocales
翻訳対象のBCP-47ロケールコードの配列(例:["de", "fr", "es", "pt-BR"])。
targetLocalesはUI翻訳のための主要なロケールリストであり、ドキュメントブロックのデフォルトロケールリストでもあります。generate-ui-languagesを使用して、sourceLocaleとtargetLocalesからui-languages.jsonマニフェストを構築します。
uiLanguage(オプション)
ツール自身のUI言語(CLIヘルプ、ログ/サマリー、および翻訳ダッシュボード)のBCP-47コード。sourceLocale / targetLocalesとは独立しており、-L / --ui-langフラグおよびAI_I18N_LANG環境変数によって上書きされます。不明な値はソースロケール(en-GB)に適切にフォールバックします — 厳密な検証は行われません。ツールUI言語を参照してください。
languagesManifestPath (オプション)
ルートレベルのオプション文字列。ドキュメントの言語切り替え機能はこのパスを読み取ります。省略した場合、最初のUIブロックのマニフェスト、つまりそのブロックの languagesManifestPath または {flatOutputDir}/ui-languages.json がデフォルトになります。各UIブロックは独自の languagesManifestPath を設定できます。ブロック0は、そのブロックで省略されている場合にこのルートパスを使用します。
以下のときに使用します:
- マニフェストは
ui.flatOutputDirの外に配置する必要があります(例えばsrc/i18n/のアプリヘルパーの隣など)。 - 言語スイッチャーの後処理(
languageListBlock)で、バンドルされたマスターカタログのみではなく、プロジェクトマニフェストからロケールラベルを構築したい場合。
includeUiLanguageEnglishNames はこのファイルを読み取りません — バンドルされたマスターカタログを使用します(下記の ui.uiExtractor を参照)。
レガシー: 設定ファイルの読み込み時にルートレベルの uiLanguagesPath は引き続き受け付けられ、自動的に languagesManifestPath に書き換えられます。
concurrency(オプション)
同時に翻訳されるターゲットロケールの最大数(translate-ui、translate-docs、translate-svg、およびsync内の対応するステップ)。省略された場合、CLIはUI翻訳には4を、ドキュメント翻訳には3を使用します(組み込みのデフォルト)。実行ごとに-j / --concurrencyで上書きします。
batchConcurrency(オプション)
translate-docs、translate-svg、およびtranslate-json(およびsync内の対応するステップ):ファイルあたりの最大並列LLMbatchリクエスト数(各バッチには多数のセグメントを含めることができます)。省略時のデフォルトは4です。translate-uiには適用されません — 代わりにuiBatchConcurrencyを使用してください。-b / --batch-concurrencyで上書きします。
uiBatchConcurrency(オプション)
translate-ui、sync-ui、およびsyncのUIステップ:単一ロケール内での最大並列LLMbatchリクエスト数(50のプレーン文字列チャンク、次に複数形グループ)。省略時のデフォルトは2です。concurrency(並列ターゲットロケール)およびbatchConcurrency(docs/JSON/SVG)とは独立しています。CLIフラグはありません。configで設定するか、プログラマティックなrunTranslateUIにuiBatchConcurrencyを渡してください。
例:
{
"uiBatchConcurrency": 2
}デフォルトのロケール並列数4の場合、最大8の実行中UI API呼び出しになります。1つの大きなロケールを翻訳する場合はこの値を上げてください(-l de)。プロバイダーがレート制限を設けている場合は低く保ってください。
fileConcurrency (オプション)
同一ロケール内で同時に処理されるファイルの最大数 (translate-docs および sync の間)。1 より大きい値に設定すると、同じロケール内のファイルがメモリ使用量を制御するセマフォを使用して並行して処理されます。省略した場合のデフォルトは 1(逐次処理)です。より高い値は、特にすべてのセグメントがすでにキャッシュされている場合(API 呼び出しが不要な場合)、I/O バウンド操作のスループットを大幅に改善できます。
例:
{
"fileConcurrency": 4
}使用例: キャッシュヒット率100%でsync --force-updateを実行する際に、この値を2-4に設定して総処理時間を短縮します。この改善は、多数の小規模ファイルを処理する場合に特に顕著です。
batchSize / maxBatchChars(オプション)
translate-docs、translate-svg、およびtranslate-jsonのセグメントバッチ処理:APIリクエストごとのセグメント数と文字数の上限。デフォルト:20セグメント、4096文字(省略した場合)。
requestTimeout / requestTimeoutMs(任意)
各LLMリクエストの最大待機時間(すべてのプロバイダーに適用)。requestTimeoutは秒単位、requestTimeoutMsはミリ秒単位です。両方が省略された場合のデフォルトは120秒です。どちらか一方のみを設定してください。いずれかのフィールドを設定したプロバイダーは、そのプロバイダーに限り、その値を使用します。
provider と providers
provider(トップレベル、オプション)は、providersからアクティブなプロバイダーキーを選択します。プロバイダーが1つだけ設定されている場合はオプションですが、複数設定されている場合は必須です。
providers(トップレベル)は、プロバイダーキーをそのブロックにマッピングします。組み込みキー(以下のプリセットテーブルを参照)にはtranslationModelsのみが必要ですが、その他のキーはカスタムのOpenAI互換エンドポイントを定義し、baseUrl(エンドポイントがキーを必要としない場合を除き、apiKeyEnvも)が必要です。
各providers.<name>ブロックは以下を受け入れます:
translationModels優先されるモデルIDの順序付きリスト(プレーンなアップストリームID、provider/プレフィックスなし。OpenRouter IDはネイティブのvendor/model形式を保持します)。最初に試行され、その後のエントリはエラー時のフォールバックです。より具体的な階層が適用されない場合、これはすべてのパイプラインのグローバルなデフォルトチェーンです。uiModels(オプション)translate-ui、複数形生成(ステップ0およびパスB)、およびproofread-ui用のUI専用モデルの順序付きリスト。ターゲットロケールに一致するlocaleModelsエントリの後に、translationModelsの前に試行されます。localeModels(オプション) すべての翻訳パイプラインに対するロケールごとの上書き。{ "locale": "<BCP-47>", "models": ["…"] }オブジェクトの配列。ロケールタグはケースインセンシティブに照合されます(pt-br=pt-BR)。各ロケールのリストは、そのロケールに対してのみ最初に試行され、次にパイプライン固有の階層(UIの場合はuiModels)とtranslationModelsが試行されます。重複する正規化されたロケールキーは、設定の読み込み時に拒否されます。baseUrlOpenAI互換のベースURL。プリセットのベースURLを上書きします。プリセット以外のプロバイダーには必須です。apiKeyEnvAPIキーを保持する環境変数。プリセットの環境変数をオーバーライドします。headersこのプロバイダーへのすべてのリクエストとともに送信される追加のHTTPヘッダー。maxTokensリクエストあたりの最大完了トークン数。デフォルト:8192。temperatureサンプリング温度。デフォルト:0.2。requestTimeoutこのプロバイダーへの各リクエストに対して待機する最大時間(秒単位)。トップレベルのrequestTimeout/requestTimeoutMsを上書きします。このプロバイダーもトップレベルの設定もタイムアウトを設定していない場合、デフォルトは120秒です。同じオブジェクト上でrequestTimeoutとrequestTimeoutMsのどちらか一方のみを設定してください。requestTimeoutMsこのプロバイダーへの各リクエストに対して待機する最大時間(ミリ秒単位)。トップレベルのrequestTimeout/requestTimeoutMsを上書きします。このプロバイダーもトップレベルの設定もタイムアウトを設定していない場合、デフォルトは120000(120秒)です。同じオブジェクト上でrequestTimeoutとrequestTimeoutMsのどちらか一方のみを設定してください。pricing(オプション) プロバイダー全体での100万トークンあたりのUSD:{ "inputPerMTokens": 0.15, "outputPerMTokens": 0.6 }。請求対象の呼び出しにプロバイダーが報告するusage.costがない場合(OpenRouterとCheaper Inference以外のほとんどのプロバイダー)、このレートがその呼び出しの入力および出力トークンに適用されます。この金額は翻訳サマリーに含まれ、api_calls行に保存されます。
コストソースは次の順序で解決されます。
- 一致する
modelPricingエントリ(このプロバイダーのデフォルトを上書きします)。 - プロバイダーが報告したコスト(置き換えられることはありません)。
- この
pricingレート。 - そのモデルIDのmodels.devリスト価格(入力および出力の100万トークンあたりのUSD)。
コストなしで保存された行は、後でusageおよび使用状況とコストによって見積もることができます。これらのソースのいずれも適用されない場合、コストは不明(—)のままで、$0.00になることはありません。
modelPricing(オプション) モデルごとの100万トークンあたりのUSD:{ "<model-id>": { "inputPerMTokens": 2.5, "outputPerMTokens": 10 } }。そのモデルIDのpricingを上書きします。プロバイダーがusage.costを省略した場合に呼び出し時に適用され、呼び出しとともに保存されます。zeroDataRetention(オプション、providers.cheaperinferenceのみ)trueの場合、チャットリクエストは"zdr": trueとlist-modelsを送信し、check-modelsとsuggest-modelsはGET /v1/models?zdr=trueをロードします。省略された場合はオフを意味します。ゼロデータ保持を参照してください。
組み込みプロバイダープリセット(キー — ベースURL — APIキー環境変数):
| プロバイダー | ベースURL | APIキー環境変数 |
|---|---|---|
alibaba | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 | ALIBABA_API_KEY |
anthropic | https://api.anthropic.com/v1 | ANTHROPIC_API_KEY |
apikeyfan | https://api.apikey.fan/v1 | APIKEYFAN_API_KEY |
cerebras | https://api.cerebras.ai/v1 | CEREBRAS_API_KEY |
cheaperinference | https://api.cheaperinference.com/v1 | CHEAPERINFERENCE_API_KEY |
deepseek | https://api.deepseek.com | DEEPSEEK_API_KEY |
gemini | https://generativelanguage.googleapis.com/v1beta/openai | GOOGLE_API_KEY |
groq | https://api.groq.com/openai/v1 | GROQ_API_KEY |
mistral | https://api.mistral.ai/v1 | MISTRAL_API_KEY |
nvidia | https://integrate.api.nvidia.com/v1 | NVIDIA_API_KEY |
ollama | http://localhost:11434/v1 | (なし) |
openai | https://api.openai.com/v1 | OPENAI_API_KEY |
openrouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
xai | https://api.x.ai/v1 | XAI_API_KEY |
apifunプリセットはapikeyfanに名称変更されました。既存の構成でproviderおよびprovidersキーを更新してください。APIFUN_API_KEYはAPIKEYFAN_API_KEYのエイリアスとして残ります。
従来のトップレベルopenrouterブロック(baseUrl、translationModels、defaultModel、fallbackModel、maxTokens、temperature、requestTimeout、requestTimeoutMsを含む)は引き続き受け付けられ、ロード時にproviders.openrouter(provider: "openrouter"を含む)へ自動マイグレーションされます。defaultModel / fallbackModelはtranslationModelsに統合されます。
1つの設定で複数のプロバイダーを構成し、-Pで切り替える実行可能な例については、examples/multi-providerを参照してください(openai、anthropic、openrouter、deepseekは同じドキュメント上にあります)。
複数のモデルを使用する理由: プロバイダーやモデルが異なれば、コストも異なり、言語やロケールによって品質のレベルも異なります。リクエストが失敗した場合に CLI が次のモデルを試せるように、translationModels を順序付けられたフォールバック チェーンとして設定します。そのリストを作成するためのガイドは AI モデル です。
以下のリストを ベースラインとして扱ってください。AI モデル のベンチマーク ランキングから置き換えてください。特定のロケールの翻訳の質が低いままの場合は、その言語またはスクリプトの localeModels エントリを追加するか、プロバイダーのカタログからさらに ID を追加してください。
これらのモデルIDはai-i18n-tools init -P openrouterが書き込むものです。他のプリセットはinit -P <provider>からネイティブモデルIDを取得します — 組み込みプロバイダーを参照してください。
このリストは、36の対象ロケールを持つ大規模なドキュメンテーションプロジェクトで広範なロケール対応のテストが行われました。実用的なデフォルトとして機能しますが、すべてのロケールで良好に動作する保証はありません。
例 translationModels (ai-i18n-tools init -P openrouterからのOpenRouterリスト):
OpenRouterのtranslationModelsリスト
"translationModels": [
"google/gemini-2.5-flash",
"meta-llama/llama-3.3-70b-instruct",
"openai/gpt-4o-mini",
"google/gemma-4-26b-a4b-it",
"~anthropic/claude-haiku-latest",
"z-ai/glm-5.2",
"google/gemini-3.5-flash",
"~anthropic/claude-sonnet-latest"
// … add more fallback models as needed
]推奨される uiModels: UI文字列は短いですが非常に目立ちます。プレミアムモデルを使用すると、トーン、複数形、一貫性が向上することがよくあります。オプションの uiModels は、一致する localeModels エントリの後、かつ translationModels の前に試行されます(上記のフィールドリストを参照)。例:
UI翻訳に推奨されるuiModels
"uiModels": [
"~anthropic/claude-sonnet-latest",
"z-ai/glm-5.2"
]アジア言語に推奨される localeModels: 日本語、韓国語、中国語のロケールは、これらのスクリプトにチューニングされたモデルを使用すると効果的であることがよくあります。ターゲットロケールが一致する場合に 最初に (uiModels / translationModels の前に)試行されるロケールごとのオーバーライドを追加します:
ja, ko, zh-Hans, zh-Hantに推奨されるlocaleModels
"localeModels": [
{ "locale": "ja", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
{ "locale": "ko", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
{ "locale": "zh-Hans", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
{ "locale": "zh-Hant", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] }
]アクティブなプロバイダーのAPIキー環境変数(プリセットテーブルを参照)を、環境または.envファイルに設定してください。
モデルリストを変更する前に、ai-i18n-tools check-modelsを実行してください。各プロバイダーについて、設定されたすべてのモデルID(translationModels、uiModels、およびすべてのlocaleModelsエントリ)をそのプロバイダーのライブモデルリスト(GET /models)と照合して検証し、欠落しているまたはexpiration_dateを過ぎたIDを報告し、有効なモデルをリスト表示し、無効なIDが1つでもあれば非ゼロで終了します。プロバイダーが価格情報を返す場合(例: OpenRouter)、推定入力/出力価格(100万トークンあたりのUSD)も表示されます。
設定したモデルを実際の翻訳作業で比較するには、ai-i18n-tools bench-modelsを実行してください。translationModels、uiModels、およびlocaleModelsのすべての一意なモデルIDについて、それぞれを個別に(並列で、concurrencyで制限)1つのサンプルを翻訳してベンチマークし、モデルごとの入力/出力トークン数、経過時間、USDコストを出力します。これにより、モデルリストを確定する前に速度と価格のバランスを検討できます。
features
| フィールド | パイプライン | 説明 |
|---|---|---|
translateUIStrings | 1 | t("…") / i18n.t("…") を strings.json に抽出し、エントリを翻訳してロケールごとのフラット JSON を書き込みます(抽出は自動的に実行されます。カタログのみを更新するには、スタンドアロンの extract を使用します)。 |
translateDocs | 2 | .md / .mdx / .astro / .html / .htm ページを翻訳します。docs[].docusaurusCatalogDir が設定されている場合は Docusaurus のシェル JSON、設定されている場合は Nextra の _meta / 辞書、docsOutput.vitepressThemeCatalog が設定されている場合は VitePress テーマ、docsOutput.style が "fumadocs" の場合は Fumadocs の meta.json / UI カタログも翻訳します。 |
translateJson | 3 | json[] 配下の任意のネストされた JSON(translate-json)。 |
translateSVG | — | .svg ファイルを翻訳(トップレベルの svg ブロックが必要です)。 |
キーが省略された場合、各フラグはデフォルトでtrueになります。動作は次のとおりです。
- 翻訳するものがない
trueが省略された場合、スキップされます。つまり、UIブロックにsourceRootsがなく、ドキュメントブロックにcontentPathsまたはdocusaurusCatalogDirがなく、json[]にcontentPathsがなく、またはsvgが設定されていません。 - そのパイプラインに作業がない場合にフラグを
trueと記述すると、設定エラーになります。 falseと記述すると、ソースが存在する場合でも、syncのそのパイプラインがオフになります。--no-ui、--no-docs、--no-json、および--no-svgは、1回の実行でそのステップをスキップします。
Translate は、features.translateSVG が true で、トップレベルの svg ブロックが設定されている場合、translate-svg を使用して SVG ファイルを翻訳します。sync コマンドは、フラグがオンで svg が設定されている場合にそのステップを実行します(--no-svg の場合を除く)。
ui
1つのカタログオブジェクト、またはカタログブロックの配列(docs[] と同じ概念)。単一のオブジェクトは読み込み時に受け入れられ、1要素の配列にラップされます。ディスク上のファイルは書き換えられません。解析後、config.ui は常に配列になります。
extract、translate-ui、sync-ui、sync のUIフェーズ、proofread-ui、export-ui-xliff、generate-ui-languages、および purge-locale は、sourceRoots を持つすべてのブロックを走査します。1つのブロックを実行するには、--ui-block に0始まりのインデックス、ブロックの description、またはその stringsJson パスを渡します。status と statistics は、ソースまたは既存のカタログを持つすべてのブロックをリストします。翻訳ダッシュボードは、そのようなすべてのカタログをリストし、複数ある場合はセレクターを表示します。
解決された stringsJson、flatOutputDir、およびマニフェストパスは、ブロック間で一意である必要があります。description の値は、設定されている場合、一意である必要があります。これは、--ui-block がそれらを完全に一致させるためです。
description設定を読む人向けのオプションのメモ(モデルには送信されません)。コマンドヘッダー、status、statistics、およびダッシュボードではui[i] — descriptionとして表示されます。sourceRootst("…")呼び出しのためにスキャンされるディレクトリまたは glob パターン(cwd からの相対パス)。src/や["src/**/*.ts"]のようなパターンをサポートします。空のリストを持つブロックは、--ui-blockで指定されていない限りスキップされますが、指定するとエラーになります。stringsJsonこのブロックのマスターカタログファイルへのパス。extractによって更新されます。flatOutputDirこのブロックのロケールごとの JSON ファイルが書き込まれるディレクトリ(de.jsonなど)。flatOutputtrue(デフォルト)の場合、translate-uiはロケールごとに1つのフラットなJSONファイルを書き込みます。gettextまたはresxのみを出力するには、falseを設定します。flatOutput: falseを含むブロックは、gettextまたはresxを設定する必要があります。resxオプションの.NET.resx出力。outputDir(デフォルトはResources)とbaseName(デフォルトはSharedResource)は、{baseName}.resxに加えて{baseName}.{culture}.resxを書き込みます。writeNeutral(デフォルトはtrue)は、ResourceManagerがフォールバックできるように、ソーステキストをニュートラルファイルに配置します。localeFormatはbcp47(デフォルト、pt-BR)またはposix(pt_BR)です。ingestExistingResx(デフォルトはtrue)は、extract中にサテライトを読み取ります。neutralFileは、LoginButtonなどのレガシーな名前付きキーをニュートラル値を介してマッピングします。コンテキストキーはU+2404を使用します。複数形は、{singular}[{form}]という名前の個別のエントリです。flatOutput: falseを含むブロックは、gettextまたはresxを設定する必要があります。gettextこのブロックのオプションのGNU gettext出力。outputDir(デフォルトは./locales)は<locale>/LC_MESSAGES/<domain>.poを受け取り、compileMoがtrue(デフォルト)の場合、一致する.moを受け取ります。domainのデフォルトはmessagesです。potPathはテンプレートカタログです。ingestExistingPo(デフォルトはtrue)は、extract中に非ファジーなmsgstr値から空のstrings.jsonスロットを埋め、空でない翻訳やユーザーが編集した翻訳を置き換えません。localeFormatはposix(デフォルト、pt_BR)またはbcp47(pt-BR)です。コンテキスト行はgettext\u0004区切り文字を使用します。2つのコンテキストで同じソース言語文字列は、カタログIDを共有しません。targetLocalesこのブロックのオプションのロケールリスト。省略または空の場合、ブロックはルートtargetLocalesを使用します。languagesManifestPathextractとgenerate-ui-languagesがこのブロックのui-languages.jsonを書き込むオプションのパス。省略された場合、ブロック0はルートlanguagesManifestPath(それ自体がこのブロックの{flatOutputDir}/ui-languages.jsonにデフォルト設定されます)を使用します。後続のブロックは{flatOutputDir}/ui-languages.jsonにデフォルト設定されます。uiGlossarytrue(デフォルト)の場合、このブロックのstrings.jsonは、translate-docs、translate-json、およびtranslate-svgの用語集ヒントソースです。translate-ui、proofread-ui、およびソースリンティングはglossary.userGlossaryのみを使用します。カタログをこれらのヒントから除外するには(たとえば、ドキュメントを誘導すべきではないCLI文字列カタログなど)、falseを設定します。uiExtractor.funcNames(またはレガシーなreactExtractor.funcNames) スキャンする追加の関数名(デフォルト:["t", "i18n.t"])。uiExtractor.extensions(またはレガシーなreactExtractor.extensions) 含めるファイル拡張子(デフォルト:[".js", ".jsx", ".ts", ".tsx"])。Astroのフロントマターとテンプレート式には.astroを追加します。uiExtractor.includePackageDescription(またはレガシーなreactExtractor.includePackageDescription)true(デフォルト)の場合、extractは、存在する場合にpackage.jsondescriptionもUI文字列として含めます。同じ説明がすべてのカタログに抽出されないように、追加のブロックでfalseを設定します。uiExtractor.packageJsonPath(またはレガシーなreactExtractor.packageJsonPath) そのオプションの説明抽出に使用されるpackage.jsonファイルへのカスタムパス。uiExtractor.includeUiLanguageEnglishNames(またはレガシーなreactExtractor.includeUiLanguageEnglishNames)
true (デフォルトはfalse) の場合、extract は、バンドルされたui-languagesマスターカタログ (sourceLocale とブロックの有効なtargetLocales から構築されます) からの各englishName を、ソーススキャンからまだ存在しない場合 (同じハッシュキーの場合) はstrings.json に追加します。languagesManifestPath は読み取りません。
uiExtractor.placeholderStyledefault(mustache、Python形式フィールド、およびprintf) またはdotnet({0}、{0,-10}、{0:format}のみ)。dotnetスタイルでは、パーセント記号はリテラルテキストであり、二重の中括弧はリテラルの中括弧です。ui-dotnetテンプレートはdotnetを設定します。uiExtractor.excludeプロジェクトルートからの相対的なMinimatchパターンは、スキャン後に破棄されます。bin、obj、.vs、TestResults、およびpackagesは、ディレクトリ名によって既にスキップされています。ui-dotnetおよびui-dotnet-resxテンプレートは、**/Tests/**、**/*.Tests/**、および**/TrExtension.csを除外します。
glossary.uiGlossary と glossary.uiGlossaryFromStringsJson は受け入れられなくなりました。設定の読み込みに失敗し、エラーで代替手段が説明されます。キーを削除してください。ヒントは現在、各ブロックの uiGlossary フラグ(デフォルトは true)から取得されます。
cacheDir
cacheDirSQLite キャッシュディレクトリ(すべてのdocsブロックで共有)。デフォルトは.translation-cacheです。実行間で再利用されます。カスタムドキュメント翻訳キャッシュから移行する場合は、アーカイブするか削除してください。cacheDirは独自の SQLite データベースを作成するため、他のスキーマとは互換性がありません。suggest-modelsはベンチマークの集計も<cacheDir>/benchmark-scores.jsonに保存します。そのファイルはディレクトリの他の部分と同様にキャッシュであり、公開パッケージの一部ではありません。
Git 除外のベストプラクティス:
- 翻訳キャッシュフォルダーの内容は除外してください (例えば、
.gitignoreや.git/info/excludeを使用)。これにより、一時的なキャッシュ成果物がコミットされるのを防ぎます。 cache.dbは保持してください (定期的に削除しないでください)。SQLite キャッシュを保持することで、変更されていないセグメントの再翻訳を防ぎます。これにより、ai-i18n-toolsを使用するソフトウェアを更新または変更する際のランタイムコストとAPIコストの両方を節約できます。- 環境ファイルと一時ファイルは除外して、シークレットとバックアップがコミットされないようにしてください。
例:
init は、デフォルトの cacheDir のためにこのブロックを書き込みます。cacheDir が異なる場合、2つのキャッシュ行はそのディレクトリを使用します。例えば .i18n-cache/* と !.i18n-cache/cache.db です。
# Cache
.translation-cache/*
!.translation-cache/cache.db
benchmark-scores.json
# Environment
.env
.env.local
.env.*.local
# Temporary files
*.tmp
*.backup.*docs
ドキュメントパイプラインブロックの配列。translate-docsとsyncのドキュメントフェーズは、各ブロックを順番に処理します。レガシーキーはロード時に引き続き受け入れられ、設定ファイルが書き込み可能であれば書き換えられます。新しい設定では現在の名前を優先してください。
| レガシーキー | 現在のキー / 動作 |
|---|---|
documentations | docs |
markdownOutput | docs[].docsOutput |
jsonSource | docs[].docusaurusCatalogDir |
トップレベルのopenrouter | providers.openrouter + provider: "openrouter" |
features.translateMarkdown | features.translateDocs |
features.translateJSON | 削除済み(docs[].docusaurusCatalogDirまたはjson[]を使用) |
features.extractUIStrings | 削除済み(extractはUI翻訳の前に実行されます) |
glossary.uiGlossary と glossary.uiGlossaryFromStringsJson | 削除されました。設定の読み込みに失敗します。ui[].uiGlossary (ブール値、デフォルトは true) を使用してください |
ui.reactExtractor | ui.uiExtractor(エイリアスは引き続き受け入れられます) |
svg.svgExtractor.forceLowercase | svg.forceLowercase |
コンテンツソース
descriptionこのブロックの任意の読み取り可能なメモ(翻訳では使用されません)。設定されている場合、translate-docs🌐ヘッドラインの先頭に付加され、statusセクションヘッダーにも表示されます。contentPaths翻訳対象の Markdown/MDX ページ本文および.astroテンプレート(translate-docsが.md、.mdx、.astroをスキャンします)。ディレクトリパスまたはワイルドカードパターン(例:"docs/**/*.md"、"guides/*.mdx"、"src/pages/index.astro")をサポートします。ローカライズされたドキュメントの本文はここから取得されます。sourceFiles読み込み時にcontentPathsにマージされる任意のエイリアス。targetLocalesこのブロックにのみ適用される任意のロケールのサブセット(指定しない場合はルートのtargetLocalesを使用)。有効なドキュメントロケールは、すべてのブロックの和集合となります。docusaurusCatalogDirオプション。このブロックの Docusaurus JSON ラベルカタログのソースディレクトリ(例:docusaurus write-translationsからの"i18n/en")。ページ本文は常にcontentPathsから取得されます。docusaurusCatalogDirはシェル/UI JSON のみを提供し、MDX は提供しません。nextraMetaGlobオプション。docsRoot配下の Nextra_meta.ts/_meta.tsx/_meta.jsのグロブ。docsOutput.styleが"nextra"で、これが省略されている場合、docsRoot配下のすべての_metaファイルが自動的に収集されます。nextraMetaTranslatableKeysオプション。Nextra_metaオブジェクトで文字列値が翻訳されるプロパティ名(デフォルト:title、display、breadcrumb)。nextraDictionaryPathオプション。英語の Nextra テーマ辞書モジュール(例:"app/_dictionaries/en.ts")。translate-docs中に{dir}/{locale}.tsに翻訳されます。nextraDictionaryOutputTemplateオプション。ロケール辞書モジュールの出力テンプレート(デフォルト: 辞書ディレクトリに対する{dir}/{locale}.ts)。
docsOutput
このブロックの出力レイアウトです。
outputDirこのブロックの翻訳済み出力のルートディレクトリ。docsOutput.style"nested"(デフォルト)、"flat"、"doc-system"、またはエイリアス"docusaurus"/"astro-starlight"/"vitepress"/"nextra"。docsOutput.localeSubpath{locale}/と{relativeToDocsRoot}の間のdoc-systemのパスセグメント(style: "doc-system"を直接使用する場合は必須。エイリアスを使用する場合はプリセット)。Starlight スタイルのロケールフォルダには""を使用します。docsOutput.docsRootDocusaurus レイアウトのソースドキュメントルート(例:"docs")。省略した場合のデフォルトは"docs"。docsOutput.pathTemplateカスタムMarkdown出力パス。プレースホルダー:"{outputDir}"、"{locale}"、"{LOCALE}"、"{llocale}"、"{relPath}"、"{stem}"、"{basename}"、"{extension}"、"{docsRoot}"、"{relativeToDocsRoot}"。docsOutput.jsonPathTemplateラベルファイルのカスタムJSON出力パス。pathTemplateと同じプレースホルダーをサポートします。docsOutput.localePathLowercasetrueの場合、組み込みの出力レイアウト(nested、flat、doc-system(pathTemplateなし))は、パスに小文字のロケールセグメントを使用します。デフォルトはfalse。astro-starlightとdoc-systemは、空のlocaleSubpathの場合、設定ロード時にデフォルトでtrueになります。docsOutput.flatPreserveRelativeDirdocsOutput.style = "flat"の場合、ソースサブディレクトリを保持して、同じベース名のファイルが衝突しないようにします。デフォルトはfalse。docsOutput.rewriteRelativeLinks翻訳後に相対リンクを書き換えます (docsOutput.style = "flat"が有効で、カスタムのpathTemplateがない場合に自動的に有効になります)。docsOutput.linkRewriteDocsRootフラットリンクの書き換えプレフィックスを計算する際に使用されるリポジトリのルート。翻訳されたドキュメントが別のプロジェクトルートにある場合を除き、通常はこれを"."のままにしておきます。docsOutput.rewriteVitepressLinkstrueの場合、翻訳後にVitePressリンク正規化ツールを実行します。docsOutput.styleが"vitepress"の場合、デフォルトで有効になります。docsRoot下のソースロケールファイルの隣にロケールフォルダがあるdoc-systemレイアウトで使用します。ソース言語はsourceLocaleであり、任意の言語にすることができます。READMEスタイルのdocs/guide/…パスをサイトルート(/guide/…)およびロケール相対../guide/…リンクに書き換えます。VitePressツリー外のリポジトリファイル(LICENSE、examples/)へのリンクには、ソースロケールファイルで完全なURLを使用してください — VitePress統合 — ドキュメントのホームページとしてのREADMEを参照してください。docsOutput.rewriteNextraLinkstrueの場合、翻訳後にNextraリンク正規化ツールを実行します。docsOutput.styleが"nextra"の場合、デフォルトで有効になります。Next.jsi18nの場合、content/en/…および相対.mdxパスをロケールに依存しないサイトルート(/guide/…)に書き換えます。Nextra統合 — リンク規則を参照してください。docsOutput.fumadocsParser"dot"(デフォルト) または"dir"。ドットはソースロケールファイルの隣にstem.{locale}.mdxを書き込み、ディレクトリはNextraのようにロケールフォルダを書き込みます。ソース言語はsourceLocaleであり、任意の言語にすることができます。Fumadocs統合 — ページレイアウトを参照してください。docsOutput.rewriteFumadocsLinkstrueの場合、翻訳後にFumadocsリンク正規化ツールを実行します。docsOutput.styleが"fumadocs"の場合、デフォルトで有効になります。コンテンツパスと相対.mdxリンクを/docs/…ルートに書き換えます。docsOutput.fumadocsUiCatalogオプション。Fumadocs UIオーバーライドカタログのブートストラップ +translate-docs内の翻訳。フィールド:sourcePath(例:lib/layout.shared.ts),catalogPath(生成された英語JSON), オプションのoutputPathTemplate(デフォルト:catalogPathの隣のui.{locale}.json)。docs[].fumadocsMetaGlobdocsOutput.styleが"fumadocs"の場合のmeta.jsonコレクション用のオプションのglob。デフォルト:docsOutput.docsRoot下の再帰的なmeta.json。docs[].fumadocsMetaTranslatableKeysFumadocs のmeta.jsonで文字列値を翻訳するプロパティ名です(デフォルト:title、description)。docsOutput.localizedAssets任意設定です。ロケールファイルが存在する場合に、翻訳後の HTML 内の画像およびアイコンの URL を置き換えます。フィールド:include(デフォルトimg/**)、pattern(デフォルト{stem}-{locale}{ext})、onlyIfExists(デフォルトtrue)、assetRoot(ルート相対 URL の確認に使用するディレクトリ。デフォルトは HTML ファイルのディレクトリ)。プレースホルダー:{stem}、{ext}、{basename}、{locale}、{llocale}、{LOCALE}。CSS のurl()は書き換えられません。詳細は HTML ページ を参照してください。docsOutput.htmlHTML ドキュメント向けの、任意の言語リストおよび hreflang の設定です。デフォルトのコメントは<!-- ai-i18n:lang-list -->…<!-- /ai-i18n:lang-list -->および<!-- ai-i18n:hreflang -->…<!-- /ai-i18n:hreflang -->です。languageList.formatはlinksまたはselectです。languageList.labelはlocal、english、bothのいずれかです。hreflang.siteUrlは代替リンクの先頭に付加されます。省略した場合、リンクは相対リンクになり、警告がログに記録されます。hreflang.xDefaultのデフォルトはsourceLocaleです。hreflang.stripIndexHtmlはindex.htmlをディレクトリ URL に変換します。HTML の場合、ロケールフォルダーが追加される前にdocsRootが削除されます(docsRootがsiteのとき、site/index.html→site/{locale}/index.html)。詳細は HTML ページ を参照してください。docsOutput.vitepressThemeCatalog任意設定です。translate-docs内で VitePress のテーマ/ナビゲーション/サイドバーのカタログを初期生成し、翻訳します。フィールド:configPath(テーマ文字列を含む VitePress 設定)、catalogPath(生成された英語のネストされた JSON)、任意のoutputPathTemplate(デフォルト:catalogPathと同じ場所にあるtheme.{locale}.json)。
ポストプロセス
docsOutput.postProcessing翻訳されたmarkdown本文に対するオプションの変換(YAMLキーおよび非プローゼのフロントマター値は保持されます)。セグメントの再構成とリンクの書き換え(フラットまたはVitePress)の後、addFrontmatterの前に実行されます。docsOutput.postProcessing.regexAdjustments{ "description"?, "search", "replace" }の順序付きリスト。searchは正規表現パターンです(プレーン文字列の場合はフラグg、または/pattern/flagsを使用)。replaceは${translatedLocale}、${sourceLocale}、${sourceFullPath}、${translatedFullPath}、${sourceFilename}、${translatedFilename}、${sourceBasedir}、${translatedBasedir}などのプレースホルダーをサポートします。docsOutput.postProcessing.languageListBlock{ "start", "end", "separator", "label"? }— ソースおよび翻訳済みmarkdown内の制限付き「他の言語で読む」リンク行を再生成します。label: "local"の場合、エンドニムラベルのためにlanguagesManifestPath(またはui.flatOutputDir/ui-languages.jsonのマニフェスト)が必要です。
動作とメタデータ
translateFrontmatterFieldsdocsOutputと同じレベル(docs[]ブロックごと)。デフォルトのtrue:Starlight/Docusaurus向けのユーザー向けYAML散文(title、description、sidebar.label、sidebar_label、keywords、hero.title、hero.tagline、hero.image.alt、hero.actions[].text、pagination_label、prev/nextのラベル)を翻訳します。falseを設定すると、フロントマターブロック全体が変更されずに維持されます。特定のドットパスに制限するには、文字列配列を渡します。segmentSplittingdocsOutputと同じレベル(docs[]ブロックごと)。translate-docs抽出のためのオプションのよりきめ細かいセグメント:{ "enabled", "maxCharsPerSegment"?, "splitPipeTables"?, "splitDenseParagraphs"?, "maxLinesPerParagraphChunk"?, "splitLongLists"?, "maxListItemsPerChunk"?, "qualityRetrySplit"?, "maxQualityRetrySplitDepth"? }。enabledがtrueの場合(segmentSplittingが省略された場合のデフォルト)、密な段落、GFMパイプテーブル(最初のチャンクにはヘッダー、セパレーター、最初のデータ行が含まれます)、および長いリストは分割されます。サブパーツは単一の改行(tightJoinPrevious)で再結合されます。"enabled": falseを設定すると、空行で区切られたボディブロックごとに1つのセグメントのみを使用します。qualityRetrySplitがtrueの場合(デフォルト)、モデルリストが停止した後にAST検証に失敗したMarkdownセグメントは、段階的に分割され、最初のモデルから再試行されます。同じ品質エラーが3回発生すると、リストは早期に停止します。maxQualityRetrySplitDepth(デフォルトは3)は再帰的な分割に上限を設けます。warnMarkdownSourceIssuestrueの場合(省略された場合のデフォルト)、各translate-docsの実行は、危険な区切り文字や閉じられていないインラインコードがないかMarkdownセグメントを再スキャンし、ターミナル警告を出力し、そのファイルのキャッシュファイルパスのmarkdown_source_issues行を置き換えます。このブロックの警告とSQLite更新をスキップするには、falseを設定します。addFrontmattertrueの場合(省略された場合のデフォルト)、翻訳されたMarkdownファイルにはYAMLキーが含まれます:translation_last_updated、source_file_mtime、source_file_hash、translation_language、source_file_path、そして少なくとも1つのセグメントにモデルメタデータがある場合はtranslation_models(アクティブなプロバイダーからのモデルIDのソート済みリスト)。スキップするにはfalseに設定します。emphasisPlaceholdersdocs[]ブロックごと。trueの場合、翻訳前にマークダウンの強調区切り文字をプレースホルダーとしてマスクします。CJKロケール(zh、ja、ko)およびrtlLocalesにリストされているロケールではtrueがデフォルトです。それ以外の場合はfalseがデフォルトです。CLI--emphasis-placeholders/--no-emphasis-placeholdersで上書き可能です。rtlLocales強調プレースホルダーのデフォルトとしてRTLとして扱われるBCP-47コードのオプションの配列(組み込みのRTL検出とマージされます)。
protectAttributes省略可能。値が引用符で囲まれた文字列となる追加のJSX/HTML属性名で、翻訳に送信しないもの。組み込みの既定値(class、id、style、src、href、type、data-*、ほとんどのaria-*など)とマージされる。大文字小文字を区別しない。対象は以下のとおり。.astroパースして置換する抽出(静的HTMLタグおよびattr=内の{expression}ブロックの文字列リテラル)。- markdown/Astroセグメントの翻訳中にMDXプレースホルダーを抽出(大文字で始まるJSXタグの
label、tooltip、aria-label、および該当する場合はTabItemvalue)。
- markdown/Astroセグメントの翻訳中にMDXプレースホルダーを抽出(大文字で始まるJSXタグの
例:"protectAttributes": ["variant", "size"]により、variant="primary"内の{items.map(...)}がすべてのロケールで変更されないまま保持される。
翻訳対象となる属性(たとえば"title"や"aria-label")を、英語からそのままコピーしたい場合にもリストに含めることができます。
protectKeys省略可能。テンプレートの{expression}ブロックおよびMDXオブジェクトリテラル内(たとえばlabel:内の<Tabs values={[ … ]}>)で、引用符で囲まれた文字列値を翻訳しない必要がある追加の オブジェクトプロパティ名。組み込みの既定値(class、key、id、href、srcなど)とマージされる。大文字小文字は区別しない。
例:"protectKeys": ["slug", "code"]により{ slug: 'getting-started', title: 'Getting started' }がスキップされる→slugが保護されている場合、titleのみが翻訳される。
例(docsOutput.style = "flat" — スクリーンショットパス+オプションの言語リストラッパー):
フラットレイアウトのpostProcessing例(スクリーンショット+languageListBlock)
"docsOutput": {
"style": "flat",
"postProcessing": {
"regexAdjustments": [
{
"description": "Per-locale screenshot folders",
"search": "images/screenshots/[^/]+/",
"replace": "images/screenshots/${translatedLocale}/"
}
],
"languageListBlock": {
"start": "<small id=\"lang-list\">",
"end": "</small>",
"separator": " · ",
"label": "local"
}
}
}json
ネストされた JSON 翻訳パイプラインのトップレベル配列。features.translateJson が true の場合(translate-json または sync の JSON ステージ)にのみ使用されます。JSON を参照してください。
| フィールド | 説明 |
|---|---|
description | CLI / status用のオプションの注釈(翻訳対象外)。 |
contentPaths | プロジェクトルート配下のソース.jsonファイル、ディレクトリ、またはグロブ。一般的なi18next名前空間ファイル(public/locales/en/*.json)がサポートされています: ネストされたオブジェクト、配列、文字列値内の{{var}}補間、および独立した複数形サフィックスキー(key_one、key_other)。 |
outputPathTemplate | 各ターゲットロケールごとの必須出力パス。プレースホルダー:{locale}、{LOCALE}、{llocale}、{stem}、{basename}、{extension}、{relativeToSourceRoot}。 |
targetLocales | このブロック用のオプションのサブセット。指定しない場合、ルートのtargetLocalesを使用。 |
keyPolicy.mode | allowlist、denylist、またはboth。 |
keyPolicy.translateKeys | モードがallowlistまたはbothの場合に含めるドットパス/グロブ。 |
keyPolicy.skipKeys | 除外するドットパス/グロブ(デフォルトの拒否リストにはid、slug、href、url、key、codeが含まれます)。 |
svg
SVGファイルのトップレベルのパスとレイアウト。features.translateSVGがtrueの場合(translate-svgまたはsyncのSVGステージ経由)にのみ翻訳が実行される。
| フィールド | 説明 |
|---|---|
sourcePath | 1つ以上のディレクトリまたはグロブパターン(例:"images/*.svg"、"**/icons/*.svg")。これらのパターンはプロジェクトルートに対して相対的に解決され、.svgファイルを再帰的にスキャンします。 |
outputDir | 翻訳されたSVG出力のルートディレクトリ。 |
style | pathTemplate が設定されていない場合のデフォルト値。"flat" または "nested"。 |
pathTemplate | カスタムSVG出力パス。使用可能なプレースホルダー: "{outputDir}"、"{locale}"、"{LOCALE}"、"{llocale}"、"{relPath}"、"{stem}"、"{basename}"、"{extension}"、"{relativeToSourceRoot}"。 |
localePathLowercase | true の場合、組み込みの flat / nested SVG レイアウトはロケールセグメントを小文字で使用します。カスタムの pathTemplate 値は変更されません。小文字のセグメントが必要な場合は {llocale} を使用してください。 |
forceLowercase | SVGを再構成する際にテキストを小文字に変換します。すべて小文字のラベルに依存するデザインで有用です。 |
modelSuggestion (オプション)
suggest-modelsとダッシュボードの「モデル」タブ用のChrFとArenaの重み、およびオプションの品質下限値。インデックスは品質のみです。ブロックを省略するか、いずれかのプロファイルを省略すると、そのプロファイルは組み込みの重みを維持します。このブロックは--applyやUpdate configによって書き換えられません。これらはモデルIDのみを書き込みます。設定が読み込まれると、プロファイル上のレガシーなpriceの重みは削除されます。
quality— デフォルトのChrF0.55、Arena0.45、品質下限値0.7price— デフォルトのChrF0.55、Arena0.45、品質下限値0.6
各プロファイルオブジェクトにはchrfとarenaが必要です。各値は有限で0以上であり、少なくとも1つは0より大きくなければなりません。それらは合計が1になるように正規化されるため、55と45はデフォルトと一致します。qualityFloorはオプションで、(0, 1]の範囲にあり、候補プール内の最高のChrFの割合です。下限値未満のモデル(ChrF測定値がないモデルを含む)は、下限値をクリアしたモデルの後にソートされます。2つのプロファイルは同じデフォルトの組み合わせを共有しますが、ソート順(インデックスによる--quality、パレートフロンティアによる--price)と下限値が異なります。
"modelSuggestion": {
"quality": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.7 },
"price": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.6 }
}glossary
| フィールド | 説明 |
|---|---|
userGlossary | 列 Original language string (または en)、locale、Translation、任意の Force、および任意の Context を含む CSV へのパス - ソース用語とターゲットロケールごとに 1 行 (locale はすべてのターゲットで * にできます)。 |
autoAddUserEditedToGlossary | trueの場合、UI文字列に対するダッシュボードの編集は、ユーザー用語集に自動的に追加できます。 |
contextFiles | 任意のcwd相対Markdownまたはプレーンテキストファイル(.md、.markdown、.txt)。製品や機能の説明を含みます。コマンド開始時にロードされ、UI、ドキュメント、JSON、SVG、および校正プロンプトに注入されます。翻訳対象にも含めたい場合を除き、これらのファイルをdocs[].contentPathsに配置しないでください。URLは拒否されます。全文が設定されたLLMプロバイダーに送信され、--debug-failedログに表示される可能性があります — 機密情報やPIIを含めないでください。 |
contextMaxChars | モデルに送信される結合済みコンテキストファイルテキストの最大文字数(デフォルト12000、ハード上限100000)。超過分のテキストは警告とともに切り詰められます。 |
labelCheckSkips | スキップするロックされたUIラベルチェックのオプションリスト。各エントリには、term(英語の用語集用語)、locales(ターゲットコード、またはすべてのロケールに対する*;デフォルトは*)、オプションのfiles(cwd相対グロブ)、およびオプションのnoteが含まれます。その用語はプロンプトヒントとして残ります。スキップは次回のtranslate-docs実行時に適用されます。 |
translate-docs、translate-json、および translate-svg は、uiGlossary が true (デフォルト) である各 UI ブロックからもヒントを取得します。これにより、そのブロックの strings.json に既に保存されている翻訳が再利用されます。ブロックを除外するには、そのブロックで uiGlossary を false に設定します。translate-ui と proofread-ui は、これらのカタログをヒントとして使用しません。短縮形の UI ラベル略語 (Alm. のような末尾にドットが付く形式、または Size → Tam のような短い単一トークンの圧縮形式) は、ドキュメントプロンプトが作り出された {{…}} トークンに誘導されないようにスキップされます。完全な製品用語と省略されていない UI 翻訳は、引き続きヒントとして利用されます。
オプションのContext CSV列は、その用語のソース言語での使用ガイダンス(定義、文法的な使用法、製品の意味)です。これは、用語が現在のバッチと一致する場合にのみ含まれます。用語のContextノートまたはcontextFilesコンテンツを変更すると、次回の実行時に一致するロケールのキャッシュされたセグメントとファイル追跡行が無効になり、翻訳が自動的に更新されます。強制されていない行で優先されるTranslationのみを変更した場合でも、--force / --force-updateを渡さない限り、既存のキャッシュが使用されます。Force行は、保存されたテキストに強制翻訳がまだ含まれていない場合に、その用語を含むソースのセグメントのみを欠落させます。ダッシュボードでユーザーが編集したキャッシュ行は保持されます。UIカタログは、そのプレフィックスが大文字で始まるラベル(少なくとも2つの内容語)であり、共有翻訳がプレースホルダーのない短いフレーズである場合、共有の複数単語プレフィックスを独自の用語としてシードします。Markdown翻訳では、ソースがそれを太字またはインラインコードスパン全体、見出し、またはそのラベルのみの行として引用する場合、カタログ翻訳を保持するために2〜5語のUIラベルが必要です。その用語を単に含む長い太字のフレーズはヒントです。文中のタイトルケースはヒントであり、翻訳は活用できます(ヒンディー語のCursor accountは、辞書形式のकर्सर खाताではなくकर्सर खातेになる場合があります)。Sign inのような単一の内容語を持つラベルはヒントのままです。チェックでは大文字/小文字は無視されます。カタログの文言を部分文字列として依然として要求するため、文法的に活用された形式は失敗する可能性があります。その失敗は警告です。セグメントは書き込まれ、用語集ラベルフラグ付きでキャッシュされ、実行の最後にglossary-review-*.mdのcacheDirの下にリストされます。確認後、labelCheckSkipsエントリを追加するか、--recheck-glossary-warningsを渡してください。--forceは、フラグが立てられた行を他のすべてのセグメントとともに再翻訳します。
例:
{
"glossary": {
"userGlossary": "i18n/glossary.csv",
"contextFiles": ["i18n/product-context.md", "i18n/billing-feature.md"],
"contextMaxChars": 12000,
"labelCheckSkips": [
{
"term": "Target language",
"locales": ["uk"],
"files": ["website/src/content/docs/docs/transform.md"],
"note": "Inflected inside a bold phrase"
}
]
}
}空の用語集CSVを生成する:
ai-i18n-tools glossary-generateリポジトリから contextFiles を作成するには、AIエージェントでコンテキストファイルを生成する のコピー&ペースト用エージェントプロンプトを使用します。用語行とコンテキストファイルの適用方法については、用語集 を参照してください。