# GitBook Agentとは？

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

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

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

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

GitBook Agent でできること:

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

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

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

次へ移動します [agent-jian-cha](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/agent-jian-cha "mention") をご覧ください。
{% 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="write-and-edit-with-ai">write-and-edit-with-ai</a></td></tr><tr><td><strong>GitBook Agent でレビューする</strong></td><td>スペル、文法、スタイルを確認するよう Agent に依頼する</td><td><a href="review-change-requests-with-gitbook-agent">review-change-requests-with-gitbook-agent</a></td></tr><tr><td><strong>ドキュメントサイトを翻訳する</strong></td><td>GitBook Agent は自動更新されるローカライズを作成できます</td><td><a href="translations">translations</a></td></tr></tbody></table>

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

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

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

変更リクエストで GitBook Agent のチャットウィンドウを開き、次に **アクションメニュー** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt=""></picture> を開いて **GitBook Agent を設定** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FwkBqgOPry9HAcW4cxJk0%2Fsettings.svg?alt=media&#x26;token=67bdbb00-ebf3-4a2d-9df8-0c822406f71c" 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 はベータ期間中、すべてのプランで無料です。

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

</details>

<details>

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

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

</details>
