> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/translations.md).
# 翻訳
{% hint style="info" %}
有効にできるのは [組織管理者](/docs/documentation/ja-gitbook-documentation/koraborshon/member-management/roles.md#admin) という理由で、翻訳を作成してアクセスできます [課金対象の機能です](#pricing).
{% endhint %}
自動翻訳を使えば、最小限の手作業で、複数言語にわたってドキュメントを最新の状態に保つのが簡単です。別のセクションの翻訳としてセクションを作成し、残りは GitBook Agent に任せられます。
## 翻訳の仕組み
* **翻訳セクションを作成する:** 既存のセクションの翻訳として新しいセクションを設定します。ソースセクションと言語を選択してください。
* **継続的な更新:** ソースコンテンツに変更を加えるたびに、翻訳ワークフローは次の対象に対してのみ実行されます: **変更されたページ**.
* **自動同期:** 変更がマージされると、翻訳ワークフローは **自動的に実行され** ソースと同期するため、翻訳済みセクションには常に最新の更新が反映されます。
{% hint style="info" %}
自動翻訳されたセクションのページスラッグは、ページに固定スラッグがない場合、変更されることがあります。言語間で URL を安定させるには、翻訳前に固定スラッグを設定してください。スラッグを更新するには、次を参照してください [URL のスラッグはどう変更できますか？](https://app.gitbook.com/s/Ua3kTfM3iWAoECzM0u90/published-documentation/custom-domains/how-can-i-change-the-slug-in-the-url)
{% endhint %}
## 自動翻訳を設定する
セクションを新しい言語に翻訳するには、組織に戻ってください **ホーム** に戻って **翻訳** サイドバーで、次をクリックします **翻訳を作成**.
で、 **翻訳を作成** モーダルで、次を選択してください:
* **ソース** — 翻訳したいセクション
* **から** 言語
* **宛先** 言語
クリックして **作成** これらのオプションを使って翻訳ワークフローを開始します。これらの設定は、セクションを複製された翻訳済みセクションとして組織内に翻訳するために使用されます。
その **翻訳** 画面には、設定済みの翻訳ワークフローも一覧表示され、ステータス、ソース、実行、翻訳されたページと単語が含まれます。ワークフローは、ソースコンテンツが更新されるたびに再実行されます。
### 詳細設定
クリックして **詳細な指示を表示** の **翻訳を作成** これらのオプションを設定するモーダル。
**カスタム AI 指示:** 口調、スタイル、その他の好みに関して AI を導くための詳細な指示を追加します。これにより、翻訳がブランドや対象読者に合うようにできます。
{% hint style="info" %}
翻訳ワークフローにカスタム指示を追加すると便利ですが、特定のケースでは制限があります。
カスタム指示を使って、翻訳済みセクションに新しい要素を作成したり、追加テキストを加えたり、ソースコンテンツの構造を変更したりすることはできません。
{% endhint %}
**用語集のサポート:** 特定の用語をどのように翻訳するかを制御するために、用語集を定義します。これにより、対応言語全体で用語を一貫させられます。
用語集の用語は、制御したいソース言語の表現と一致している必要があります。GitBook は、翻訳実行中にそれらを適用して用語の一貫性を保ちます。
たとえば、ソース言語が英語で、用語集に `SSO` → `SSO` 、 `Git Sync` → `Git Sync`が含まれている場合、「Set up SSO with Git Sync」のような文では、それらの用語は翻訳結果でも変更されません。
{% hint style="warning" %}
**用語集を変更すると、コンテンツ全体の再翻訳が実行されます**。現時点では回避策はありません。どのページに用語集のキーワードが含まれているかを確実には検出できないため、最も安全な方法はすべてのページを再翻訳することです。そのため、用語集の更新には時間と費用がかかる場合があります。
{% endhint %}
## バリアントに翻訳を追加する
翻訳を作成した後、公開済みの docs サイトに次のものとして追加できます [バリエーション](/docs/documentation/ja-gitbook-documentation/saitowo/site-structure/variants.md)。これにより、メインの docs サイトを表示するときに、ユーザーは右上で言語を切り替えられるようになります。
{% hint style="info" %}
ユーザーに最適な体験を提供するため、設定時にバリアントの既定言語を設定できます。
バリアントを設定する際は、翻訳済みセクションの言語を追加するのがベストプラクティスです。
{% endhint %}
翻訳用の新しいバリアントを設定するには、次から構造エディタを開きます **サイト構造**の下の **一般** サイトのサイドバーから。
## 料金
翻訳は有料アドオンです。翻訳料金は、メインのサブスクリプションと同じ月次または年次サイクルで請求されます。
* 月額料金: 月あたり最大 50,000 語の翻訳で月額 $25
* 年額料金: 月あたり最大 50,000 語の翻訳で年額 $250
* 追加 1,000 語ごとに $0.20
月間上限は毎月初めにリセットされます。$0.20 の料金は、年額サブスクリプションを含め、追加の 1,000 語ごとに適用されます。
「月額」は料金と語数上限を指します。請求サイクルを指すものではありません。
最初の翻訳では、すべての単語が請求対象になります。その後は、 **ページ** 新規または更新された単語を含むものだけが課金されます。たとえば、後で docs を編集した場合、語数上限の対象になるのは新しい単語があるページだけです。ドキュメント全体に対して再請求されることはありません。
{% hint style="warning" %}
複数の翻訳を大きなページで扱う場合は注意してください。翻訳語数には、変更が含まれるページ内のすべての単語が含まれるため、大きなページで数語だけ変更された場合でも、ページ全体が再翻訳されます。
{% endhint %}
## よくある質問
自動翻訳を使う理由
* **手間いらずの多言語ドキュメント:** 手作業の翻訳なしで、世界中の読者に届けられます。
* **かしこい更新:** 変更されたページだけが再翻訳されるため、時間とリソースを節約できます。
* **完全な管理:** 詳細な指示と用語集管理で翻訳をカスタマイズできます。
翻訳を編集できますか？
現在、翻訳は編集できません。
翻訳はソースコンテンツの純粋な変換として行われるため、翻訳結果に対する編集内容を新しい翻訳と照合することはできません。
それを回避するには、次の流れをおすすめします:
* AI に使わせたい特定の翻訳を定義するために用語集を使用する
* 出力を調整するためにカスタム指示を使用する
いくつの翻訳を作成する必要がありますか？
作成すべきなのは **言語ごとに 1 つの翻訳ワークフロー** です。複数のワークフローを作成すると、組織内で余分な重複コストが発生します。
現在の制限にはどのようなものがありますか？
* 翻訳では、バリアント内の UI 要素は自動的にローカライズされません。次を開いてください **カスタマイズ**の下の **ツール** サイトのサイドバーで、 [インターフェースをローカライズする](/docs/documentation/ja-gitbook-documentation/saitowo/customization/extra-configuration.md#localize-user-interface) のために [特定のバリアント](/docs/documentation/ja-gitbook-documentation/saitowo/customization.md#customizing-sites-with-multiple-sections-or-variants).
* これには、告知バナーなど、ユーザー入力によるカスタマイズが含まれます。
* 翻訳では、ページにヒントや AI によって翻訳されたことを示すバナーのような追加コンテンツを加えることはできません。これを示すために、翻訳済みセクションに追加ページを作成するか、次のものを追加することを検討してください [告知バナー](/docs/documentation/ja-gitbook-documentation/saitowo/customization/layout-and-structure.md#announcement-premium-and-ultimate) をサイトのバリアントに。
* 用語集を変更すると、すべてのページの完全な再翻訳が実行され、処理時間とコストが増える可能性があります。現時点では、用語集の使用に基づく部分的な再翻訳はできません。
始め方のサポートが必要な場合や、自動翻訳の設定についてさらに詳しく知りたい場合は、 [サポートチームにお問い合わせください](broken://pages/55ca09da2fc64db3d290bfa3cf9175afa45c2bdc).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/translations.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.