> 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 洞察

AI 洞察显示访客在问什么，以及回答效果如何 [GitBook Assistant](/docs/documentation/zh/wei-ni-de-du-zhe-ti-gong-ai/gitbook-ai-assistant.md) 并使用你的内容进行响应。

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

#### AI 洞察仪表板

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

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

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

<figure><img src="/files/80153715f080f1adcb6b2d829f0243d4df4cc908" alt=""><figcaption><p>AI 洞察界面。</p></figcaption></figure>

### 主题

该 **主题** 视图显示各个主题随时间的表现，并列出与每个主题相关的问题。

<figure><img src="/files/cdc9b904f244850f036e1469cb7cf1e6cb130416" alt=""><figcaption><p>AI 洞察中的主题详情视图。</p></figcaption></figure>

#### 此主题中的问题

GitBook 按以下方式对主题中的问题分组： **类型** 或者 **最近程度**. 可用它来查看重复出现的需求、发现文档空白，并了解你的网站是否成功回答了该领域的问题。

点击任意问题可打开问题详情视图。

### 问题

该 **问题** 视图显示 GitBook Assistant 如何处理某个访客问题，以及哪些内容支撑了该回答。

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

<figure><img src="/files/1f4e059cdebd55a95d0a47dce415b944a38d7561" alt=""><figcaption><p>AI 洞察中的问题详情视图。</p></figcaption></figure>

#### 对话与回答质量

在摘要下方，你可以查看与该问题相关的对话，并了解 GitBook 是完全回答、部分回答还是未回答。对话面板还会显示完整的 Assistant 交互，包括任何后续问题和回复。

#### 来源与上下文

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

### 常见问题

<details>

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

AI 洞察可让你的团队概览访客在查找答案时如何与文档互动。

筛选 AI 洞察有助于你识别内容缺口。你可以按以下内容筛选：

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

弥补这些缺口有助于访客更快找到答案——并更快理解你的产品。

{% hint style="info" %}
即将推出：我们正在开发一些功能，帮助你的团队通过……自动修复内容缺口 [GitBook 代理](broken://pages/155dafccc07f944f2a09205d69e1c7ba7bea602a).

参见 [自动改进文档](/docs/documentation/zh/gitbook-agent/automatic-docs-improvements.md) 了解更多。
{% 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.