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

# AI 洞察

查看用户实际向 GitBook Assistant 提出的内容，并找出文档不足的知识空白

AI 洞察展示了访客在询问什么，以及回答得有多有效 [GitBook 助手](/docs/documentation/zh/mian-xiang-du-zhe-de-ai/gitbook-ai-assistant.md) 会使用你的内容进行回应。

要打开 AI 洞察，请点击 **洞察** 在你的网站概览中。

#### AI 洞察仪表板

AI 洞察仪表板通过四个关键指标为你提供网站概览：

* **节省：** 通过 GitBook 助手回答问题所估算节省的工作量
* **问题：** 访客提出的独特问题
* **已回答：** 成功处理的问题百分比
* **主题：** 按共同主题排序的内容洞察

点击任意主题以打开主题详情视图。

<figure><img src="https://2111890564-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://2111890564-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 助手如何处理某位访客的问题，以及哪些内容支持了该回答。

当你点击某个问题时，详情视图会打开。在屏幕顶部，你可以查看问题本身、访客提问的频率、其类型以及它所属的主题。

<figure><img src="https://2111890564-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 是完全、部分还是完全没有回答。对话面板还会显示完整的助手交流内容，包括任何后续问题和回复。

#### 来源与上下文

来源部分显示哪些页面、记录或 [已连接内容](/docs/documentation/zh/mian-xiang-du-zhe-de-ai/connections.md) 是 GitBook 用来回答问题的。可用它来验证 AI 是否引用了正确的内容——并找出相关页面存在但未被展示的地方。

### 常见问题

<details>

<summary><strong>我该如何使用 AI 洞察？</strong></summary>

AI 洞察为你的团队提供访客在寻找答案时如何与文档互动的概览。

筛选 AI 洞察可帮助你识别内容缺口。你可以按以下条件筛选：

* 访客最常提出的问题
* 访客搜索但没有答案的问题
* 你的文档未涵盖的主题

解决这些缺口可帮助访客更快找到答案——并更快理解你的产品。

{% hint style="info" %}
[内容缺口](/docs/documentation/zh/fen-xi/content-gaps.md) 会将这些缺口汇总为一个排名列表，而 GitBook Agent 可以打开变更请求来填补其中一个。
{% 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/zh/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.