要收集和查看反馈，你必须先在控制台的 附加组件 页面中启用反馈功能。
反馈类型
上下文反馈和代码片段反馈需要 Enterprise 方案。
- 点赞评分：通过简单的点赞/点踩投票来衡量用户对页面的整体满意度。
- 编辑建议：允许用户为你的文档提出编辑建议。仅适用于公开的 GitHub 仓库。
- 提交 Issue：允许用户直接从文档中在 GitHub 上创建 Issue。仅适用于公开的 GitHub 仓库。
- 上下文反馈：针对页面内容的自由填写反馈。
- 代码片段反馈：专门针对代码片段的反馈。
- Agent 反馈：由访问你文档的第三方 AI Agent 提交的反馈。
收集邮箱地址
- 前往控制台中的 附加组件 页面。
- 在反馈设置中启用 Collect reader emails 开关。
- 可选择添加隐私声明，说明你的团队如何使用收集到的邮箱。
如果你在
docs.json 文件中禁用了 telemetry，反馈功能将无法使用。管理反馈
更改反馈状态
- 待处理 (Pending)：反馈正在等待审核。
- 进行中 (In Progress)：正在进行修复工作以解决该反馈。
- 已解决 (Resolved)：反馈已被解决。
- 已忽略 (Dismissed)：反馈不相关或不准确。
按状态筛选
按类型筛选
- Ratings by page：查看哪些页面获得了最多的正面和负面反馈。使用这些量化数据来识别用户认为最有用和最无用的页面。
- Detailed feedback：查看用户在页面上留下的开放式反馈，以便针对特定页面进行有针对性的改进。Detailed feedback 仅显示包含附加信息的反馈。仅使用赞或踩评分而未选择附加反馈选项的提交不会出现在详细视图中。
- Code snippets：查看用户在代码片段上留下的开放式反馈，以便针对特定代码块进行有针对性的改进。
添加内部备注
导出反馈
Agent 反馈
Agent 反馈目前处于测试版 (Beta)，可能会有所变化。
Agent 反馈的工作原理
<AgentInstructions> 块。
Agent 通过向端点发送页面路径和反馈文本来提交反馈。反馈会与人工反馈一同显示在控制台中。
反馈端点始终以 POST 请求的形式在 https://你的域名.com/feedback 上可用，即使你没有将指令添加到 Markdown 导出中。因此你可以提示 Agent 通过直接向端点发送请求来手动提交反馈。
启用 Agent 反馈
- 前往控制台中的 附加组件 页面。
- 启用 Agent feedback 开关。
通过 API 获取 Agent 反馈
source=agent 筛选以仅返回 Agent 反馈。
Agent 反馈响应包括：
comment：Agent 提交的反馈文本。path：反馈所涉及页面的路径。
使用反馈数据
- 识别表现良好的内容：正向反馈最多的页面可以帮助你了解文档中哪些部分效果最好。
- 优先改进：负面反馈最多的页面表明哪些内容可能需要优先优化。
- 采取行动：根据用户的直接反馈对文档进行更新。