# GitBook Agent とは？

GitBook Agent は、あなたのそばで作業する AI のチームメイトであり、ドキュメントを正確・完全・最新の状態に保つのを助けます。

Agent は GitBook に深く統合されているため、その利点を活用するのに新しいワークフローを学ぶ必要はありません。すでに知っている手順を使って、あなたのそばで動作します。

{% hint style="info" %}
ローカル環境で AI アシスタントを使ってドキュメントを編集したい場合は、 [GitBook の skill.md ファイル](/docs/documentation/ja-gitbook-documentation/creating-content/ai-coding-assistants-and-skillmd.md).
{% endhint %}

### GitBook Agent で何ができますか？

GitBook Agent でできること:

* **プロンプトをもとにドキュメントを書く:** Agent に、ページを最新情報に更新する、製品名の記載をすべて新しい名前に置き換える、その他必要なことを依頼できます。
* **コンテンツを GitBook に取り込む:** Agent のチャットサイドバーに、PDF や Microsoft Word 文書などのファイルを添付できます。Agent はコンテンツを抽出し、あなたのスペース内のページとして整形できます。
* **より大きな変更を構想し、実装する:** 必要なことを説明すると、Agent が変更リクエストを開き、計画している編集内容を説明し、あなたのフィードバックに応答したうえで、一緒に作成した計画を実装します。
* **スタイルガイドを理解する:** サイト設定にスタイルガイドを追加すると、Agent はコンテンツの作成やレビューの際にそれを適用します。
* **カスタムのサイトレベル指示に従う:** 特定のリンクの追加方法や特定のブロックタイプの回避など、サイトごとに Agent に具体的な指示を与えられます。
* **ドキュメントを翻訳する:** 翻訳したいコンテンツと言語を選択すると、Agent がドキュメントのローカライズ作業を行います。
* **コメントから呼び出す:** ページ上の任意のブロックにコメントを追加し、@gitbook と入力して、必要なことを Agent に伝えます。
* **変更リクエストをレビューする:** 変更リクエストのレビュー担当者として Agent を追加できます。Agent はドキュメントのリンターとして機能し、エラーの特定や修正、改善提案、スタイルガイドからの逸脱の検出を行えます。

#### 自動ドキュメント提案

{% hint style="warning" %}
**自動ドキュメント提案は早期アクセスです**

次へ移動します [Agent 監査](/docs/documentation/ja-gitbook-documentation/gitbook-agent/agent-audit.md) をご覧ください。
{% endhint %}

Agent は、チームが製品やユーザーのニーズを理解するために使っているのと同じシグナル、つまりサポート会話、チケット、接続済みツールのスレッドにも接続できます。

このコンテキストにより、Agent はギャップを主体的に特定し、更新を提案し、ドキュメントの変更を自動生成できます。こうして、ドキュメントが製品とともに進化しても、ユーザーは必要なときに必要な場所で常に正しい情報を得られます。

### GitBook Agent の機能を見る

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>GitBook Agent で書く</strong></td><td>プロンプトに基づいてコンテンツを作成するか、単一のブロックを編集する</td><td><a href="/pages/056d4d54fb57eafaa7dd77c46051432d19b07d11">/pages/056d4d54fb57eafaa7dd77c46051432d19b07d11</a></td></tr><tr><td><strong>GitBook Agent でレビューする</strong></td><td>スペル、文法、スタイルを確認するよう Agent に依頼する</td><td><a href="/pages/56d8c0a5316af738cb2ada7644589fc0f538d4cb">/pages/56d8c0a5316af738cb2ada7644589fc0f538d4cb</a></td></tr><tr><td><strong>ドキュメントサイトを翻訳する</strong></td><td>GitBook Agent は自動更新されるローカライズを作成できます</td><td><a href="/pages/1a7c49b5a9850056c5818eef2c3c6aa37e41bb38">/pages/1a7c49b5a9850056c5818eef2c3c6aa37e41bb38</a></td></tr></tbody></table>

### スタイルガイドとカスタム指示を追加する

チームのスタイルガイドや、サイト上での動作方法に関する具体的な指示を追加することで、GitBook Agent を設定できます。Agent は、そのサイト向けのコンテンツを作成または編集するたびに、これらをコンテキストとして使用します。

スタイルガイドまたはカスタム指示を追加するには、サイトの **設定** を開き、次に **エージェント** タブを選択します。カスタム指示フィールドに指示を追加してください。

変更リクエストで GitBook Agent のチャットウィンドウを開き、次に **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt=""></picture> を開いて **GitBook Agent を設定** <picture><source srcset="/files/CG9bVSmdbJnQxrYiNbRI" media="(prefers-color-scheme: dark)"><img src="/files/477fc6b8be7ea4395872753916f62023abc28604" alt=""></picture>.

#### カスタム指示の例

以下は、GitBook Agent の設定に追加できるカスタム指示の例です。

{% code overflow="wrap" %}

```
あなたは Stripe のテクニカルライターです。明確で直接的な言葉を使い、華美さより正確さを優先してください。ガイドでは、必ず 1 文の要約で概念を導入し、内容を適切に構成されたセクションに分けてください。クイックスタートでは、必ずステッパーを使い、各ステップは必ず行動を先に示し、簡潔にしてください。
```

{% endcode %}

### よくある質問

<details>

<summary>GitBook Agent は私のデータをどのように使いますか?</summary>

私たちは、データを非公開に保つため、常にデータ保護の慣行に従っています。

GitBook Agent は、AI モデルの学習にあなたのデータを使用しません。GitBook Agent に追加した情報は、GitBook AI の機能を提供する目的のみに限り、OpenAI と共有します。詳細は OpenAI のプライバシーポリシーをご確認ください。

</details>

<details>

<summary>GitBook Agent の料金はいくらですか?</summary>

GitBook Agent はベータ期間中、すべてのプランで無料です。

[翻訳](/docs/documentation/ja-gitbook-documentation/gitbook-agent/translations.md) は月額アドオンとして別途料金が設定されています。 [料金セクション](/docs/documentation/ja-gitbook-documentation/gitbook-agent/translations.md#pricing) で詳細を確認できます。

</details>

<details>

<summary>GitBook Agent の出力のデフォルトのトーンを上書きできますか?</summary>

はい、GitBook Agent のデフォルトの個性やトーンは上書きできます。より冗長な出力にしたい場合や、特定のスタイルやトーンに従わせたい場合は、サイトレベルの指示、または変更リクエスト内の個別のプロンプトで、Agent に伝えるだけです。

</details>


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
