← 指南

面向 AEO 的知识库:让用户能照着说明完成任务

如果读者没有相应权限、套餐不包含某项功能,或界面的菜单名称已经变了,只写“打开设置,启用功能”就不够。说明文档需要先交代这些条件,帮助用户判断这套步骤是否适用于自己的账号。

为 AEO 改进知识库时,先确认用户能否读懂说明并完成任务。内容应准确、完整。即使 AI 引用了这篇文档,遗漏的步骤仍会妨碍使用。

先写条件,再写操作

在步骤之前说明适用人群、产品版本或部署方式,以及需要提前准备什么。会导致整个流程无法执行的条件,不能藏在结尾。

GitLab 的双重身份验证文档列出了使用条件、操作步骤和恢复访问的相关链接。这里用它说明帮助文档如何组织,不据此判断 AI 引用效果。

把一项操作写完整

下表以“导出订单”为教学示例,说明一份完整操作指南需要包含什么。它不描述真实产品界面;编写自己的指南时,需要逐项核实权限、格式和菜单名称。

部分发布前确认
任务用户要导出哪些订单
条件权限、功能可用性、日期范围限制
步骤当前界面中的真实路径
结果文件在哪里出现,包含什么
异常文件或记录缺失时先检查什么
求助无法解决时向哪里求助

用适当的测试账号走一遍,也检查权限不足的情况。文章应该帮助用户认出障碍,而不是指向一个看不到的按钮。公开示例中不要放客户数据、访问密钥或内部操作流程。

按任务拆分,按需要链接

如果用户会分别查找导出操作和文件字段说明,可以将它们写成两页,并在用到详细解释的位置添加链接。同一流程的步骤应便于连续阅读,不要为了增加短答案页面而拆散。

旧版本说明要标明适用范围。流程被替换之后,先确认是否仍有人需要旧说明,再决定删除或重定向。只有产品名称,无法说明操作适用于哪个版本或部署方式。

不只安排作者,也安排维护人

页面需要一位能及时得知功能变化的负责人。把文档检查放入产品发布流程:菜单、限制或操作结果变了,相应说明和翻译也需要复查。只有实际检查过内容,才应修改页面的更新日期。

标记和机器人文件不能代替维护。Google 不要求特殊 AI 文件来支持其 AI 功能。文件本身的用途另见 llms.txt 指南

知识库较大时,可以先检查一项常用操作及其相关页面。AEO 实施可包含约定的结构调整、文稿修订和技术修改,产品功能及限制则需要由您的团队确认。

发布日期: · 由 geo-rank.ai 编辑团队审核 · 我们如何检查