02 / CASE STUDYCOMPANY PROJECT · LAUNCHED

AI 文档答疑助手

AI Document Q&A Assistant

让产品文档 从「可阅读」 变成「可提问」。

Knowledge BaseRAGPrompt IterationUser Support
RoleAI Application & Knowledge Design
StatusLaunched
ScopeKnowledge · Prompt · Testing · Iteration
PRODUCT GUIDE / 01
RAG / INDEX
01 PRODUCT DOCUMENT02 KNOWLEDGE INDEX03 USER QUESTION04 AI ANSWER
01

THE PROBLEM

文档已经存在,为什么用户还是找不到答案?

产品文档承担着大量知识传递工作。但在实际使用中,用户遇到问题时,往往并不知道答案在哪一篇文档里、应该搜索什么关键词,或者应该从哪个章节开始阅读。

传统文档要求用户找到正确文档、理解目录结构、搜索关键词、阅读上下文,再自己判断答案。对于不熟悉产品的新用户来说,“有文档”并不等于“能找到答案”。

找到正确文档
理解目录结构
搜索关键词
阅读上下文
自己判断答案
THE CORE GAP

The problem was not a lack of documentation.
The problem was the distance between documentation and questions.
问题不是没有文档,而是文档的组织方式,与用户理解问题和提出问题的方式并不相同。

02

THE GAP

用户不会按照文档目录的方式提问

DOCUMENT LANGUAGE

01功能配置说明

02权限管理

03异常处理

04部署流程

05常见问题

USER LANGUAGE

01“这个怎么配置?”

02“为什么没有权限?”

03“运行失败怎么办?”

04“部署以后为什么没反应?”

05“这个报错是什么意思?”

DOCUMENT STRUCTUREUSER INTENT

文档按照产品结构组织。

用户按照问题发生的场景提问。

03

MY ROLE

我的角色:让产品知识更容易被 AI 找到和回答

公司提供 AI 产品及知识库等底层能力。

我的工作重点不是开发底层 RAG 技术,而是围绕真实用户问题,持续优化知识内容与 AI 回答效果。

01

整理并撰写产品文档与知识材料

02

建设和维护 AI 知识库

03

根据 AI 检索效果调整知识内容

04

测试真实用户问题

05

调试 Prompt 与回答方式

06

发现知识缺口与 Bad Case

07

持续优化答疑体验

MY FOCUS

不是让 AI “读过文档”,
而是让它在用户真正提出问题时,能够找到正确的知识并给出有用的回答。

04

FROM DOCUMENT TO KNOWLEDGE

把文档上传进去,并不意味着 AI 就能回答好问题

原始产品文档主要为人类阅读而设计。一篇完整文档可能同时包含背景说明、操作步骤、注意事项、异常处理和多个功能主题。

AI 检索知识时,需要找到与当前问题最相关的内容。因此知识库建设不只是上传文档,而是理解结构、组织知识、测试检索并持续调整内容。

DOCUMENT
UNDERSTAND STRUCTURE
ORGANIZE KNOWLEDGE
TEST RETRIEVAL
REFINE CONTENT
ORIGINAL DOCUMENT某产品功能
完整操作手册
ORGANIZED KNOWLEDGE
01功能说明INDEXED
02配置步骤INDEXED
03使用条件INDEXED
04异常情况INDEXED
05注意事项INDEXED
05

HOW IT WORKS

一个用户问题,是如何找到答案的?

以下内容为脱敏 Demo,不包含真实产品名称、公司信息或内部敏感资料。

01USER QUESTION自然语言描述问题
02KNOWLEDGE RETRIEVAL寻找相关知识
03CONTEXT配置条件与注意事项
04AI ANSWER基于知识生成回答
05REFERENCE继续阅读或排查
SANITIZED Q&A DEMOREFERENCE AVAILABLE
USER QUESTION

怎么安装浏览器插件?

RETRIEVED KNOWLEDGE
配置条件
生效检查
AI ANSWER

可能原因:当前配置尚未满足生效条件。

建议步骤:请先检查必要设置是否完整保存,再确认相关服务状态。

REFERENCE / 相关配置说明 ↗
06

ANSWER DESIGN

一个好的答案,不只是“回答正确”

用户遇到产品问题时,通常需要的不只是知识解释,而是知道现在发生了什么、应该怎么做,以及如果还没解决,下一步怎么办。

因此回答设计需要同时兼顾准确、清楚、可执行和有边界。以下仅展示 Prompt 设计原则,不包含完整内部 Prompt。

01

ACCURACY

基于已有知识回答

Answer from available knowledge
02

CLARITY

使用用户能够理解的语言

Use clear and simple language
03

ACTIONABILITY

提供可以执行的下一步

Give actionable steps when possible
04

BOUNDARY

没有依据时不编造

Do not invent unsupported information
07

WHEN AI DOESN'T KNOW

AI 不知道答案时,应该怎么办?

一个可靠的 AI 答疑产品,不仅要设计“如何回答”,还要设计“无法可靠回答时怎么办”。

当知识不足时,承认不确定并引导下一步,比生成一个看似完整但没有依据的答案更重要。

WRONG PATH

NO RELEVANT KNOWLEDGE

GENERATE ANYWAY

HALLUCINATION
RELIABLE PATH

NO RELEVANT KNOWLEDGE

ACKNOWLEDGE UNCERTAINTY

GUIDE NEXT ACTION
“抱歉,目前知识库中暂未找到关于这一问题的详细说明。 你可以: 1. 补充具体的使用场景或报错信息,我会继续帮你排查; 2. 前往官方帮助中心查看相关文档; 3. 如果问题仍未解决,通过人工支持进一步确认。”

A useful AI should know when not to answer.
可靠,有时意味着知道什么时候不应该回答。

08

TESTING & ITERATION

AI 答不好时,我会从哪里开始找问题?

AI 答疑效果不是一次配置完成的。真实问题会不断暴露知识缺失、检索不准确、问题理解偏差,以及回答不够清楚或缺乏可执行性。

因此,我通过真实问题持续测试和优化。当前没有足够的真实量化结果,本页不展示未经验证的准确率、满意度或节省时间比例。

01USER QUESTION
02AI ANSWER
03REVIEW RESULT
04FIND THE GAP
KNOWLEDGE GAP

补充或调整知识

RETRIEVAL ISSUE

优化知识组织方式

ANSWER ISSUE

调整 Prompt 与回答要求

RETEST IMPROVE
WHAT I LOOK FOR

01答案是否基于正确知识

02是否真正回答用户的问题

03步骤是否清晰、可执行

04信息不足时是否保持边界

05相似问题的回答是否稳定

09

WHAT I LEARNED

知识库不是一个“把文档放进去”的地方

这个项目让我意识到,AI 知识库的质量不仅取决于有多少文档。

  • 01知识如何组织
  • 02用户如何提问
  • 03AI 如何检索
  • 04回答失败后如何继续优化

文档解决的是“信息在哪里”。

AI 答疑需要解决的是:当用户真正遇到问题时,能否得到一个有用的答案。

NEXT PROJECT03

AI 求职辅助工具

让每一次求职沟通,
都针对具体岗位而写。

Next Case Study