> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-647791c7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 收集来自用户和 AI 智能体的页面反馈

> 启用反馈小部件、页面评分、上下文备注、代码片段反应以及智能体反馈，帮助你发现并修复文档中的问题。

<Info>
  反馈功能需要 [Pro 或 Enterprise 套餐](https://mintlify.com/pricing?ref=feedback)。
</Info>

[分析](https://app.mintlify.com/analytics)页面的反馈部分显示您的页面从用户那里收到的定量点赞与点踩投票,以及用户提供的任何定性反馈。使用这些信息来评估内容质量并进行改进。

查看您的反馈数据可以:

* **识别成功的内容**:获得最多正面反馈的页面显示了您文档中效果良好的部分。
* **确定改进优先级**:获得最多负面反馈的页面表明哪些内容可能需要关注。
* **采取行动**:根据用户的直接反馈进行文档更新。

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mintlify-mintlify-647791c7/WG2bkYANPyKtR7s4/images/analytics/feedback-light.png?fit=max&auto=format&n=WG2bkYANPyKtR7s4&q=85&s=c1fb4dd9a1fc7afc9b332102909fb268" alt="分析页面中的反馈标签页。" width="2329" height="663" data-path="images/analytics/feedback-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mintlify-mintlify-647791c7/WG2bkYANPyKtR7s4/images/analytics/feedback-dark.png?fit=max&auto=format&n=WG2bkYANPyKtR7s4&q=85&s=6365045e302dfa0388d9dd44fbfbae35" alt="分析页面中的反馈标签页。" width="2329" height="663" data-path="images/analytics/feedback-dark.png" />
</Frame>

<div id="enable-feedback">
  ## 启用反馈
</div>

<Note>
  如果您在 `docs.json` 文件中禁用了遥测,则无法启用反馈功能。
</Note>

要收集和查看用户反馈,您必须从仪表板中的 [Add-ons](https://app.mintlify.com/products/addons) 页面启用反馈功能。

1. 导航到 [Add-ons](https://app.mintlify.com/products/addons) 页面。
2. 启用您想要的反馈类型。

* **Thumbs rating**:简单的点赞/点踩投票,用于评估用户对页面的整体满意度。
* **Edit suggestions**:允许用户对您的文档提出编辑建议。仅适用于公开的仓库。
* **Raise issues**:允许用户直接从您的网站创建 issue。仅适用于公开的仓库。
* **Contextual feedback**:关于页面内容的自由格式反馈。可以选择启用电子邮件收集,允许用户在提交反馈时提供其电子邮件地址。
* **Code snippet feedback**:专门针对代码片段的反馈。

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mintlify-mintlify-647791c7/WG2bkYANPyKtR7s4/images/analytics/feedback-addons-light.png?fit=max&auto=format&n=WG2bkYANPyKtR7s4&q=85&s=d5221f9adb7fb8952f60a44b42e488a6" alt="Add-ons 页面中的反馈开关。" width="1858" height="1280" data-path="images/analytics/feedback-addons-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mintlify-mintlify-647791c7/WG2bkYANPyKtR7s4/images/analytics/feedback-addons-dark.png?fit=max&auto=format&n=WG2bkYANPyKtR7s4&q=85&s=d57abf97e2185ca8fb6be2f881111806" alt="Add-ons 页面中的反馈开关。" width="1860" height="1280" data-path="images/analytics/feedback-addons-dark.png" />
</Frame>

<div id="manage-feedback">
  ## 管理反馈
</div>

您可以设置某条反馈的状态,并添加内部备注,以跟踪您处理用户反馈的进度。

<div id="change-feedback-status">
  ### 更改反馈状态
</div>

选择某条反馈旁边的状态,将其标记为 **Pending**(待处理)、**In Progress**(进行中)、**Resolved**(已解决)或 **Dismissed**(已忽略)。

设置反馈状态的最佳实践:

* **Pending**:反馈正在等待审核。
* **In Progress**:正在处理该反馈。
* **Resolved**:您已解决该反馈。
* **Dismissed**:反馈无关或不准确。

<div id="filter-by-status">
  ### 按状态筛选
</div>

使用 **Filters** 菜单控制显示哪些反馈。清除某个状态可以隐藏所有该状态的反馈。默认情况下会显示所有反馈类型。

<div id="filter-by-type">
  ### 按类型筛选
</div>

根据您想要分析的信息,在 **Ratings by page**、**Detailed feedback** 和 **Code snippets** 之间进行选择。

* **Ratings by page**:查看哪些页面收到的正面和负面反馈最多。使用这些定量数据来识别用户认为最有帮助和最没有帮助的页面。
* **Detailed feedback**:查看用户在页面上留下的开放式反馈,以识别针对特定页面的定向改进。详细反馈仅显示包含额外信息的反馈。仅使用点赞或点踩评分而未选择其他反馈选项的提交不会出现在详细视图中。
* **Code snippets**:查看用户在代码片段上留下的开放式反馈,以识别针对特定代码块的定向改进。

<div id="add-internal-notes">
  ### 添加内部备注
</div>

点击某条反馈以添加内部备注。这些备注仅对有权访问您仪表板的人员可见。

使用备注来添加协作信息、链接相关的支持或工程工单,或记录任何其他有用的信息。

<div id="agent-feedback">
  ## 智能体反馈
</div>

<Note>
  智能体反馈处于测试版,可能会发生变化。
</Note>

第三方 AI 智能体可以针对发现不正确、过时或难以使用的页面提交结构化反馈。

这些反馈会显示在 **Detailed feedback** 部分,并带有 **Agent** 标记。管理智能体反馈的方式与管理人类反馈相同。

<div id="how-agent-feedback-works">
  ### 智能体反馈的工作原理
</div>

智能体可以通过两种方式提交反馈:

* **Search MCP 服务器**:连接到您站点的 [Search MCP 服务器](/zh/ai/model-context-protocol)后,智能体可以发现并调用 `submit_feedback` 工具。该工具需要页面路径和问题描述。
* **HTTP 端点**:能够发出 `POST` 请求的智能体可以将页面路径和反馈文本直接提交到 `https://your-domain.com/feedback`。这种方式不需要 MCP 连接。

例如:

```bash theme={null}
curl --request POST \
  --url https://your-domain.com/feedback \
  --header 'Content-Type: application/json' \
  --data '{
    "path": "/quickstart",
    "feedback": "此页面上的安装命令已过时。"
  }'
```

<Note>
  网页搜索和网页获取工具不会为智能体提供 `submit_feedback` MCP 工具。仅支持 `GET` 请求的智能体无法提交反馈。它需要连接到您的 Search MCP 服务器,或具备发出 HTTP `POST` 请求的能力。
</Note>

两种方式都会将提交记录为指定页面的负面反馈。反馈将与人类反馈一起显示在仪表板中。

<div id="retrieve-agent-feedback-via-api">
  ### 通过 API 获取智能体反馈
</div>

使用[分析反馈端点](/zh/api/analytics/feedback)以编程方式获取智能体反馈。使用 `source=agent` 进行筛选,仅返回智能体反馈。

智能体反馈响应包括:

* `comment`:智能体提交的反馈文本。
* `path`:反馈所针对页面的路径。