> 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 がそれを埋める変更リクエストを開けます。
サイトのサイドバーで、次へ移動します **改善 → Content gaps**.
上部の4つのタイルには、GitBook が見つけたギャップの数、重大度が高いギャップの数、ギャップからマージされた変更リクエストの数、そして最も多く寄与しているソースが表示されます。
## GitBook が検出するもの
GitBook は 4 種類の問題を分類します:
* **コンテンツのギャップ** GitBook が、ドキュメントでは答えにくい製品に関する質問を顧客がしているのを検出したときに発生します。たとえば、次のようなものです：
* 顧客がサポートチームに、ドキュメントで見つけられなかった質問をすること。
* API エンドポイントのドキュメントが不完全であること。
* **古くなったコンテンツ** ページ上のコンテンツが、次のような外部ソースで見つかったコンテンツに置き換えられている場合に検出されます：
* 関数のシグネチャを変更した SDK の更新。
* 有料機能が無料プランに移行したのに、ドキュメントが更新されていないこと。
* **誤ったコンテンツ** ドキュメントサイト上のコンテンツが明らかに誤っている場合にフラグが付けられます。たとえば、次のようなものです：
* すでに存在しない API、または機能が終了した API を指しているガイド。
* マーケティングサイトなどの外部ソースが、ドキュメントと一致しない場合。
* **その他** 上記のカテゴリに当てはまらない問題を対象にします。
## 仕組み
{% stepper %}
{% step %}
#### ソースを接続する
GitBook は、ドキュメントを、顧客がすでに質問している場所――サポートチケットシステム、公開フォーラム、マーケティングサイト――と比較できるほど、より多くのギャップを見つけます。一部のソースは、セットアップ完了前に追加の API キーや認証が必要です。 [接続についてさらに詳しく見る。](/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/connections.md)
{% endstep %}
{% step %}
#### GitBook は毎日スキャンします
GitBook は1日1回ソースを確認し、見つかった内容を公開済みコンテンツと比較します。ドキュメントで答えられない質問はすべてギャップになります。
{% endstep %}
{% step %}
#### ギャップを確認する
各 gap には、問題、その裏付けとなる証拠、そして修正のための推奨事項が示されます。重大度で並べ替えて、最初に修正すべき gap を見つけましょう。
{% endstep %}
{% step %}
#### 埋めるか却下する
次を作成してギャップを埋めます [変更リクエスト](/docs/documentation/ja-gitbook-documentation/collaborate/change-requests.md) そこから埋めるか、対応したくないものは却下します。GitBook は却下した gap を再度開きません。
{% endstep %}
{% endstepper %}
## 一覧を絞り込む
バックカタログが多いサイトでは、一度に何千もの抜け漏れが見つかることがあります。一覧を絞り込んで、対応する価値のあるものを見つけましょう:
| フィルター | オプション | 用途 |
| -------------- | ----------------------------------- | ------------------------------------------------------------------------------ |
| ステータス | **未対応**, **変更済み**, **却下**, **解決済み** | まだ手を付けていない gap と、すでに変更リクエストでカバーされているもの、チームが却下した提案、マージ済みの変更リクエストで閉じられたものを区別します。 |
| 重大度 | **高**, **中**, **低** | 最も影響の大きい抜け漏れから対応しましょう。 |
| 日付 | **過去 7 日間**, **過去 30 日間** | 最近のリリースやサポート件数の急増で何が見つかったかを確認しましょう。 |
| トピック | サイト上の任意のトピック | ドキュメントの特定の領域に集中します。トピックは AI Assistant レポートと同じ方法でグループ化されます。 |
| 種類 | コンテンツの抜け漏れ、古いコンテンツ、誤ったコンテンツ、その他 | 不足しているドキュメントと、問題のあるドキュメントを分けて表示します。 |
| ソース | 接続済みの任意のソース | Intercom だけに見えている抜け漏れなど、単一のソースが報告している内容を確認できます。 |
| GitBook エージェント | 対応済み、未対応 | まだ誰も取り上げていない抜け漏れを見つけます。 |
フィルタされた一覧を重大度で並べ替えて、最も影響の大きいギャップを上位に表示します。
gap を却下すると、チームがその提案を検討し、採用しないと判断したことが記録されます。これにより、判断が下された事実を隠さずに open list から外せます。で絞り込む **解決済み** マージ済みの変更リクエストがすでに閉じた gap を見つけるために。
## gap を確認する
ギャップのレビューは毎回同じ手順で行います：
1. Content gaps ページで、取り組みたい gap に絞ってリストをフィルタします。
2. gap をクリックして開きます。
3. 次を読みます **問題**, **証拠**、そして **推奨事項** gap が実際に存在し、埋める価値があるかを判断するために。
4. リンクされたソース記録を開いて、自分で証拠を確認してください。
5. クリック **変更リクエストを作成する**、また **却下** gap を埋める価値がない場合。
6. GitBook Agent が下書きした変更リクエストを確認し、マージします。
### gap が示すもの
ギャップを開くと、その名前、ステータス、重大度、種類、トピックが表示されます。ステータスはドロップダウンなので、ギャップを離れずに変更できます。その下には、 **背景** セクションでは、事例を3つの部分に分けて示します：
* **問題** ドキュメントが何を説明できていないのか、そしてその結果読者に何が起こるのかを示します。
* **証拠** GitBook が見つけた内容を示します。現在どのページがその領域をカバーしているか、何が抜けているか、そしてソース記録に人々が何を求めていると示されているかです。
* **推奨事項** 何を書くべきか、どこに配置するべきかを提案します。リンク元にするページも含まれます。
背景の下には、その指摘の根拠となるソース記録が GitBook によって一覧表示されます。個々のサポート会話、議論、またはページで、それぞれリンクされているため、元の内容を開いて全文を読むことができます。
{% hint style="info" %}
ソース記録は、接続しているソースについてのみ表示されます。サポート会話から抽出された gap は、そのサポートプラットフォームが接続されている場合にのみ、その会話を表示します。参照： [接続](/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/connections.md) 設定するには。
{% endhint %}
### gap から変更リクエストを作成する
gap を自動的に修正できる場合、バナーにその指摘は変更リクエストで解決できると表示され、2 つの操作が提示されます。
クリック **変更リクエストを作成する** gap を GitBook Agent に渡します。Agent は指摘内容と、それが示すページを読み取り、変更案を下書きします。修正対象が複数のページにまたがる場合、1 つの gap から複数の変更リクエストが生成されることがあります。
Agent が作業している間、画面には進捗が表示され、その後、生成された内容が各項目の確認リンク付きで一覧表示されます。そこからは他のどの変更リクエストとも同様に扱われます [変更リクエスト](/docs/documentation/ja-gitbook-documentation/collaborate/change-requests.md) — どのコンテンツが変更されたかを正確に確認でき、通常のレビューとマージのルールが適用されます。参照： [GitBook Agent で変更リクエストをレビューする](/docs/documentation/ja-gitbook-documentation/gitbook-agent/review-change-requests-with-gitbook-agent.md) Agent がそのレビューをどのように支援できるかについて。
変更リクエストをマージすると gap は解決され、キューから削除されます。で絞り込んで **解決済み** 再び見つけるために。
### gap を却下する
クリック **却下** gap を埋める価値がない場合—質問がスコープ外である、ページですでに答えが示されている、または指摘が証拠を誤って読み取っている—です。却下すると gap は open list から外れ、GitBook は再度開きません。
{% hint style="info" %}
ギャップのステータスを変更するには、却下を含め、サイトでの編集権限が必要です。使用できない操作は無効化され、理由が表示されます。
{% endhint %}
## 自分のエージェントからギャップを扱う
Content gaps ページの内容はすべて、 [GitBook API](https://gitbook.com/docs/developers/gitbook-api/api-reference) また [GitBook MCP server](/docs/documentation/ja-gitbook-documentation/docs-as-code/gitbook-mcp.md)そのため、自分のエージェントやスクリプトは、GitBook アプリの外でギャップを処理できます。エージェントやスクリプトでできることは次のとおりです:
* サイトのギャップを一覧表示し、それぞれの裏付けとなる証拠（ソースレコード、AI Assistant の質問、それが影響するページ）を確認できます。
* ギャップを解決、却下、または再オープンできます。
* GitBook Agent に変更リクエストを生成させてギャップを修正するよう依頼します。これは **変更リクエストを作成する** アプリで行うのと同じです。
* 自分で作成した変更リクエストを、それが修正するギャップにリンクするには、その `siteFindingId`を設定します。ギャップにリンクされたすべての変更リクエストがマージされると、ギャップは解決済みになります。
## 設定
コンテンツの抜け漏れページで、 **設定** をクリックすると、GitBook がどのソースをスキャンしているか、また各ソースが何を提供しているかを確認できます。
### ソース
この **ソース** 一覧には、取り込み中のすべての接続、スキャン済みの内容、そこから発生した抜け漏れの数が表示されます。各ソースは独自の単位で報告します。たとえば、Web サイトならページ、YouTube チャンネルなら動画、GitHub Discussions ならディスカッション、サポートプラットフォームなら会話です。
あなたのドキュメント自体も、独自のソースです。 **AI アシスタント** サイトの訪問者が尋ねた未回答の質問と、それに由来するギャップの両方をレポートします。詳しくは [AI アシスタント](/docs/documentation/ja-gitbook-documentation/analytics/insights/ai-insights.md) レポートでそれらの質問をすべて確認してください。
各ソースは、接続に付けたラベルの下に表示されるため、2つの Web サイト接続は1つの項目にまとめられず、別々に表示されます。
クリック **コンテンツのギャップを表示** 任意のソースで、そのソースの抜け漏れに一覧を絞り込めます。
### 接続
この **接続** このセクションでは、まだ接続していないソースが表示されます。たとえば Zendesk、Freshdesk、Front、HubSpot、Zoho Desk、Pylon、GitHub Issues、MCP サーバーなどです。
クリック **接続を管理** を開くと、ソースの追加、同期ステータスとレコード数の確認、検索順位の設定、GitBook が取り込んだ個別レコードの閲覧ができます。参照 [接続](/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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/analytics/content-gaps.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
