> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/analytics/content-gaps.md).

# コンテンツのギャップ

ドキュメントが答えていない質問を深刻度順に見つけ、GitBook Agentで補完しましょう

{% hint style="info" %}
Content gaps はベータ版で、Ultimate サイトプランで利用できます。
{% endhint %}

Content gaps は、ドキュメントが答えていない内容を示します。GitBook は、接続したソースからのサポートチケット、メール、フォーラム、その他の記録に加えて、ドキュメント内で訪問者が尋ねる質問をスキャンします。1日に1回、それらの質問をコンテンツと照らし合わせ、ドキュメントで答えられていないものを特定し、深刻度順に並べます。

どのギャップからでも、GitBook Agent がそれを埋める変更リクエストを開けます。

サイトのサイドバーで、次の項目に移動します。 **改善 → コンテンツギャップ**.

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-489320e17f7eef5f995911b381ba4de6ea54d1af%2Fcontent-gaps.png?alt=media" alt="The Content gaps screen showing summary tiles, the filter row, and a list of gaps with their topics and evidence counts"><figcaption></figcaption></figure>

上部の4つのタイルには、GitBook が見つけたギャップの数、重大度が高いギャップの数、ギャップからマージされた変更リクエストの数、そして最も多く寄与しているソースが表示されます。

## GitBook が検出するもの

GitBook は 4 種類の問題を分類します:

* **コンテンツギャップ** GitBook が、ドキュメントでは十分に回答できていない製品に関する質問を顧客がしていると認識したときに発生します。例：
  * ドキュメントで見つけられなかった質問を、サポートチームに顧客が尋ねている。
  * API エンドポイントのドキュメントが不完全であること。
* **古くなったコンテンツ** ページの内容が、外部ソースにある内容によって更新されている場合に検出されます。例：
  * 関数のシグネチャを変更した SDK の更新。
  * 有料機能が無料プランに移行したのに、ドキュメントが更新されていないこと。
* **誤ったコンテンツ** ドキュメントサイトの内容に明らかな誤りがある場合にフラグが付けられます。例：
  * すでに存在しない API、または機能が終了した API を指しているガイド。
  * マーケティングサイトなどの外部ソースが、ドキュメントと一致しない場合。
* **その他** 上記のカテゴリに当てはまらない問題が含まれます。

## 仕組み

{% stepper %}
{% step %}

#### ソースを接続する

顧客がすでに質問している場所（サポートチケット管理システム、公開フォーラム、マーケティングサイトなど）とドキュメントを比較できると、GitBook はより多くのギャップを見つけられます。ソースによっては、セットアップを完了する前に追加の API キーや認証が必要です。 [接続について詳しく見る。](https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/connections.md)
{% endstep %}

{% step %}

#### GitBook は毎日スキャンします

GitBook は1日1回ソースを確認し、見つかった内容を公開済みコンテンツと比較します。ドキュメントで答えられない質問はすべてギャップになります。
{% endstep %}

{% step %}

#### ギャップを確認する

各 gap には、問題、その裏付けとなる証拠、そして修正のための推奨事項が示されます。重大度で並べ替えて、最初に修正すべき gap を見つけましょう。
{% endstep %}

{% step %}

#### 埋めるか却下する

ギャップを解消するには、そこから [変更リクエスト](https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaborate/change-requests.md) を作成するか、対応しないギャップを却下します。GitBook は却下されたギャップを再度開くことはありません。
{% endstep %}
{% endstepper %}

## 一覧を絞り込む

バックカタログが多いサイトでは、一度に何千もの抜け漏れが見つかることがあります。一覧を絞り込んで、対応する価値のあるものを見つけましょう:

| フィルター          | オプション                                 | 用途                                                                             |
| -------------- | ------------------------------------- | ------------------------------------------------------------------------------ |
| ステータス          | **未対応**, **変更済み**, **却下済み**, **解決済み** | まだ手を付けていない gap と、すでに変更リクエストでカバーされているもの、チームが却下した提案、マージ済みの変更リクエストで閉じられたものを区別します。 |
| 重大度            | **高**, **中**, **低**                   | 最も影響の大きい抜け漏れから対応しましょう。                                                         |
| 日付             | **過去7日間**, **過去30日間**                 | 最近のリリースやサポート件数の急増で何が見つかったかを確認しましょう。                                            |
| トピック           | サイト上の任意のトピック                          | ドキュメントの特定の領域に集中します。トピックは AI Assistant レポートと同じ方法でグループ化されます。                     |
| 種類             | コンテンツの抜け漏れ、古いコンテンツ、誤ったコンテンツ、その他       | 不足しているドキュメントと、問題のあるドキュメントを分けて表示します。                                            |
| ソース            | 接続済みの任意のソース                           | Intercom だけに見えている抜け漏れなど、単一のソースが報告している内容を確認できます。                                |
| GitBook エージェント | 対応済み、未対応                              | まだ誰も取り上げていない抜け漏れを見つけます。                                                        |

フィルタされた一覧を重大度で並べ替えて、最も影響の大きいギャップを上位に表示します。

ギャップを却下すると、チームが提案を検討したうえで対応しないと判断したことが記録されます。判断の記録を残したまま、未対応の一覧から除外できます。フィルターで **解決済み** を選択すると、マージ済みの変更リクエストによって解消されたギャップを確認できます。

## gap を確認する

ギャップのレビューは毎回同じ手順で行います：

1. Content gaps ページで、取り組みたい gap に絞ってリストをフィルタします。
2. gap をクリックして開きます。
3. 「 **問題**, **根拠**」と「 **推奨事項** を読んで、そのギャップが実在し、解消する価値があるか判断します。
4. リンクされたソース記録を開いて、自分で証拠を確認してください。
5. 「 **変更リクエストを作成**」または **「却下」** をクリックします。ギャップを解消する価値がない場合は、却下してください。
6. GitBook Agent が下書きした変更リクエストを確認し、マージします。

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-42b4c70f8e2337ff35332e9dec1383df4bf35e2f%2F25_03_30_site_findings%402x.png?alt=media" alt="A single content gap showing its status, severity, type, and topic, with Reject and Create change request actions above the motivation"><figcaption></figcaption></figure>

### gap が示すもの

ギャップを開くと、名前、ステータス、重大度、種類、トピックが表示されます。ステータスはドロップダウンになっているため、ギャップの画面を離れずに変更できます。その下の「 **背景** 」セクションでは、次の3つの項目で根拠を説明します。

* **問題** ドキュメントで説明できていないことと、その結果読者に何が起こるかを示します。
* **根拠** GitBook が見つけた情報を示します。現在どのページでその内容を扱っているか、何が不足しているか、また、ソースの記録からどのような質問が寄せられているかを確認できます。
* **推奨事項** 何をどこに書くか、また、どのページからリンクするかを提案します。

背景の下には、その指摘の根拠となるソース記録が GitBook によって一覧表示されます。個々のサポート会話、議論、またはページで、それぞれリンクされているため、元の内容を開いて全文を読むことができます。

{% hint style="info" %}
ソースの記録は、接続済みのソースについてのみ表示されます。サポートでの会話から作成されたギャップには、該当するサポートプラットフォームが接続されている場合にのみ、その会話が表示されます。設定するには、 [接続](https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/connections.md) をご覧ください。
{% endhint %}

### gap から変更リクエストを作成する

gap を自動的に修正できる場合、バナーにその指摘は変更リクエストで解決できると表示され、2 つの操作が提示されます。

クリック **変更リクエストを作成** して、ギャップをGitBook Agentに渡します。Agentは指摘内容と、そこに記載されたページを読み取り、変更案を作成します。修正が複数のページにまたがる場合、1つのギャップから複数の変更リクエストが作成されることがあります。

Agentの作業中は画面に進捗が表示され、完了すると作成された内容と、それぞれを確認するためのリンクが一覧表示されます。作成された変更リクエストは、ほかの [変更リクエスト](https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaborate/change-requests.md) と同様に扱えます。変更されたコンテンツを正確に確認でき、通常のレビューおよびマージのルールが適用されます。Agentによるレビュー支援については、 [GitBook Agent で変更リクエストをレビューする](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-jento/review-change-requests-with-gitbook-agent.md) をご覧ください。

変更リクエストをマージするとギャップが解決され、キューから削除されます。 **解決済み** で絞り込むと、再度見つけることができます。

### gap を却下する

ギャップを埋める必要がない場合は、 **却下** をクリックします。質問が対象範囲外である、ページですでに回答されている、または指摘が根拠を誤って解釈している、といった場合です。却下すると、そのギャップは未解決の一覧に表示されなくなり、GitBookによって再びオープンされることもありません。

{% hint style="info" %}
ギャップのステータスを変更するには、却下を含め、サイトでの編集権限が必要です。使用できない操作は無効化され、理由が表示されます。
{% endhint %}

## 自分のエージェントからギャップを扱う

「コンテンツのギャップ」ページにあるすべての機能は、 [GitBook API](https://gitbook.com/docs/developers/gitbook-api/api-reference) および [GitBook MCPサーバー](https://gitbook.com/docs/documentation/ja-gitbook-documentation/docs-as-code/gitbook-mcp.md)からも利用できるため、独自のエージェントやスクリプトを使って、GitBookアプリの外部でギャップに対応できます。エージェントやスクリプトでは、次の操作が可能です。

* サイトのギャップを一覧表示し、それぞれの裏付けとなる証拠（ソースレコード、AI Assistant の質問、それが影響するページ）を確認できます。
* ギャップを解決、却下、または再オープンできます。
* アプリでの **変更リクエストの作成** と同様に、GitBook Agentにギャップの修正を依頼して、変更リクエストを作成する。
* 自分で作成した変更リクエストを、その変更で修正するギャップにリンクするには、 `siteFindingId`を設定します。ギャップにリンクされたすべての変更リクエストがマージされると、そのギャップは解決済みになります。

## 設定

「コンテンツのギャップ」ページで **設定** をクリックすると、GitBookがスキャンするソースと、それぞれのソースから得られる情報を確認できます。

### ソース

「 **ソース** 」一覧には、データを取り込んでいるすべての接続、そのスキャン対象、そこから発生したギャップの数が表示されます。報告単位はソースごとに異なります。ウェブサイトはページ、YouTubeチャンネルは動画、GitHub Discussionsはディスカッション、サポートプラットフォームは会話が単位となります。

ドキュメント自体も独立したソースです。 **AIアシスタント** は、サイト訪問者が質問したものの回答が得られなかった内容と、それらから生じたギャップの両方を報告します。質問の詳細を確認するには、 [AI アシスタント](https://gitbook.com/docs/documentation/ja-gitbook-documentation/analytics/insights/ai-insights.md) レポートをご覧ください。

各ソースは、接続に付けたラベルの下に表示されるため、2つの Web サイト接続は1つの項目にまとめられず、別々に表示されます。

任意のソースで **コンテンツのギャップを表示** をクリックすると、そのソースのギャップだけに一覧を絞り込めます。

### 接続

「 **接続** 」セクションには、Zendesk、Freshdesk、Front、HubSpot、Zoho Desk、Pylon、GitHub Issues、MCPサーバーなど、まだ接続していないソースが表示されます。

「 **接続を管理** 」をクリックすると「接続」ページが開きます。ここでは、ソースの追加、同期ステータスとレコード数の確認、検索順位の設定、GitBookが取り込んだ個々のレコードの閲覧ができます。各コネクタのインデックス対象と設定方法については、 [接続](https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/connections.md) をご覧ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/analytics/content-gaps.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
