AI 产品的文档，读者不止是人，还有别的 AI。2025 年 10 月到 2026 年 2 月，我们给一个 agent 编排平台做文档改造，重点是让它更容易被回答引擎引用，四个月里被引用的次数从每周 3 次左右到 15 次以上。
位置一：定义段
每个核心概念第一段必须是一句可独立引用的话。比如“工具调用（tool call）指模型在生成过程中调用外部函数并读取返回值的过程”。这句话脱离上下文也成立，AI 引用时不会失真。
很多文档的开头是“在本节中我们将介绍……”，这种句子对 AI 没有任何价值。我们删了客户文档里 30 多处这种过渡句。
位置二：能力边界
AI 引用你的产品时，最常回答的问题是“XX 能做什么、不能做什么”。所以文档里要有一节明确写边界：支持哪些模型、上下文上限多少、并发限制、哪些场景不适用。
我们把这个部分做成表格，每行一个维度，给具体数字。这张表被引用的频率最高，因为它能被直接拆成答案。我们每季度核对一次数字，别让过期的上限被引用出去。
位置三：错误与失败模式
AI 产品一定会失败，文档写清失败模式反而加分。“工具调用超时怎么处理”“模型返回格式不合法怎么办”“上下文超长时丢哪部分”，这三类问答几乎每个用户都会问，也是 AI 最容易被问到的。
写法是问答体：问题一句话，答案三句以内给结论，再展开。
位置四：对比和替代
文档里加一节“和其他方案的区别”。注意是区别，不是贬低。写清适用场景的边界，比如“如果你只需要简单的链式调用，用脚本就行，不需要这个平台”。
这一节在 AI 回答里出现率高得惊人。用户问“XX 和 YY 哪个好”，AI 需要的是中立的差异描述，不是广告。
一个判断标准
写完一段文档，问自己：这段话能不能被单独摘出来，作为某个问题的答案？能，就达标；不能，就是给人看的上下文，AI 用不上。
还有一件事要排进流程：能力边界那节挂进发版检查清单，版本上线必须同步改。AI 产品迭代快，被引用出去的旧数字比没被引用更麻烦。
这件事的收益不在点击，在曝光。被 AI 提到 100 次，可能只带来 5 次访问，但那 5 次是带着信任来的。我们追踪过一个客户，从 AI 引用进入的访客，试用转化率是自然搜索的 2.3 倍。
元析智能
为软件公司做 SEO 和 GEO 优化