# 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" %}
**自動ドキュメント提案は早期アクセスです**

次へ移動します [エージェント監査](/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>プロンプトに基づいてコンテンツを作成する、または 1 つのブロックを編集する</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 %}

### FAQ

<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.
