# GitBook Agentとは？

GitBook Agentはあなたと共に働くAIチームメイトであり、ドキュメントを正確に、完全に、最新の状態に保つ手助けをします。

AgentはGitBookに深く統合されているため、新しいワークフローを学ぶ必要はありません — 既に知っているプロセスに沿ってあなたと一緒に動作します。

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

### GitBook Agentは何ができるのか？

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

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

チームのスタイルガイドや、チームでどのように動作させたいかという具体的な指示を追加して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のテクニカルライターです。明確で直接的な言葉を使い、装飾よりも正確さを優先してください。ガイドでは常に1文の要約で概念を導入し、コンテンツをよく構成されたセクションに分けてください。クイックスタートでは必ずステッパーを使い、各ステップは行動を優先した簡潔な表現にしてください。
</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.com/docs/documentation/ja-gitbook-documentation/gitbook-jento/translations) は月額アドオンとして別途料金がかかります。詳細は [料金セクション](https://gitbook.com/docs/documentation/ja-gitbook-documentation/translations#pricing) をご覧ください。

</details>

<details>

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

はい、GitBook Agentのデフォルトの性格やトーンを上書きできます。より冗長な出力にしたり、特定のスタイルやトーンに従わせたい場合は、組織全体の指示に記載するか、変更リクエスト内の個別のプロンプトでAgentに指示してください。

</details>
