# 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は以下のことができます：

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

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

Agentは、あなたのチームが製品やユーザーのニーズを理解するために使用する同じシグナル（サポート会話、チケット、接続されたツールのスレッドなど）にも接続できます。

このコンテキストがあれば、Agentは積極的にギャップを特定し、更新を提案し、ドキュメントの変更を自動生成できます。これによりドキュメントは製品とともに進化し、ユーザーは必要なときに適切な情報を得られます。

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

に移動してください **組織設定 → GitBook Agent** でアクセスをリクエストしてください。
{% endhint %}

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

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

チームのスタイルガイドや、Agentにチームでどのように動作してほしいかの具体的指示を追加して、GitBook Agentを設定できます。Agentは組織内でコンテンツを作成または編集する際にこれらをコンテキストとして使用します。

スタイルガイドやカスタム指示を追加するには、あなたの **組織設定** を開き、次に **GitBook 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の設定に追加できるカスタム指示の例です。

<pre data-overflow="wrap"><code><strong>あなたはStripeのテクニカルライターです。明確で直接的な言葉を使い、装飾よりも正確さを優先してください。ガイドでは、常に概念を一文の要約で紹介し、内容をよく構造化されたセクションに分けてください。クイックスタートでは、常にステッパーを使い、各ステップをアクション優先かつ簡潔に保ってください。
</strong></code></pre>

### よくある質問

<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/gitbookjentogitbook-agent/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>
