> 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/fen-xi/ai-insights.md).

# AI インサイト

ユーザーが GitBook Assistant に実際に何を尋ねているのかを確認し、ドキュメントの不足している知識を特定します

AIインサイトでは、訪問者が何を質問しているか、そしてどれだけ効果的に [GitBook Assistant](/docs/documentation/ja-gitbook-documentation/kenoai/gitbook-ai-assistant.md) あなたのコンテンツを使って応答します。

AIインサイトを開くには、 **インサイト** サイトの概要から。

#### AIインサイトダッシュボード

AIインサイトダッシュボードでは、次の4つの主要な指標でサイトの概要を把握できます：

* **節約：** GitBook Assistant が質問に回答することで削減された作業量の推定値
* **質問：** 訪問者から寄せられた固有の質問
* **回答済み：** 質問に正常に対応できた割合
* **トピック：** 共通のテーマごとに整理されたコンテンツのインサイト

任意のトピックをクリックすると、トピック詳細ビューが開きます。

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FfgnkTISKUGFVMNrMyPB7%2F25_03_30_site_insights%402x.png?alt=media&amp;token=a1a21cf5-7760-472f-84fc-7797b9d6bd67" alt=""><figcaption><p>AIインサイト画面。</p></figcaption></figure>

### トピック

この **トピック** ビューでは、各トピックの経時的な推移と、それぞれに関連する質問が表示されます。

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FBCXlAQAdvmi0jvvfnZSb%2F25_03_30_site_insights_topic%402x.png?alt=media&amp;token=e5b9ba01-9940-401c-9abd-ea9ff5508467" alt=""><figcaption><p>AIインサイトのトピック詳細ビュー。</p></figcaption></figure>

#### このトピックの質問

GitBook は、トピック内の質問を次の基準でグループ化します **種類** または **新しさ**。これを使って、繰り返し発生するニーズを確認し、ドキュメントの不足を見つけ、その領域でサイトが質問にうまく答えられているかを把握できます。

任意の質問をクリックすると、質問詳細ビューが開きます。

### 質問

この **質問** ビューでは、GitBook Assistant が個別の訪問者の質問にどのように対応したか、またどのコンテンツがその回答を支えたかを表示します。

質問をクリックすると、詳細ビューが開きます。画面上部では、その質問自体、訪問者がその質問をどのくらいの頻度で行ったか、その種類、そして属するトピックを確認できます。

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FBovDnj9k4ZENjM3Kv5j2%2F25_03_30_site_insights_question%402x.png?alt=media&amp;token=ddfad917-86ca-4e2e-9979-a2b687dbe82a" alt=""><figcaption><p>AIインサイトの質問詳細ビュー。</p></figcaption></figure>

#### 会話と回答品質

要約の下では、その質問に関連する会話を確認し、GitBook がそれに完全に、部分的に、またはまったく回答できたかを確認できます。会話パネルには、フォローアップの質問や応答を含む、Assistant のやり取り全体も表示されます。

#### ソースとコンテキスト

ソースセクションには、どのページ、レコード、または [接続されたコンテンツ](/docs/documentation/ja-gitbook-documentation/kenoai/connections.md) を使って GitBook がその質問に答えたかが表示されます。これを使って、AI が正しいコンテンツを参照しているかを確認し、関連ページはあるのに表示されていない箇所を見つけられます。

### FAQ

<details>

<summary><strong>AIインサイトはどのように使いますか？</strong></summary>

AIインサイトは、答えを探している訪問者がドキュメントとどのようにやり取りしているかをチームに把握させます。

AIインサイトをフィルタリングすると、コンテンツの不足箇所を特定できます。次の条件で絞り込めます：

* 訪問者が最もよく尋ねる質問
* 訪問者が検索しても回答がない質問
* ドキュメントで扱っていないトピック

こうした不足を解消することで、訪問者はより早く答えを見つけられ、製品をより早く理解できます。

{% hint style="info" %}
[コンテンツのギャップ](/docs/documentation/ja-gitbook-documentation/fen-xi/content-gaps.md) これらの不足を優先順位付きリストにまとめ、GitBook Agent がそのうちの1件を埋めるための変更リクエストを開くことができます。
{% endhint %}

</details>


---

# 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/fen-xi/ai-insights.md?ask=<question>&goal=<endgoal>
```

`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.
