AI引用官网技术文档时专挑过时版本,我按模块拆了半个月才摸清规律
最近碰到一个特别膈应的事儿:我们官网有一份产品技术文档,从v2.1一直更到v4.3,每个大版本都保留着历史页面。结果我拿AI搜「API鉴权方式」,它张嘴就引v2.1那版,里面写的鉴权参数早就不支持了。客户那边按着老文档对接,白调了一周接口,气得我直接拉日志对。
我先干的事是把官网所有技术文档页面的抓取记录导出来,按「模块」拆开——鉴权、限流、错误码、回调,四大块。然后拿AI回答里引用的URL跟抓取频次、最后抓取时间做交叉对比,跑了两周,发现一个规律:AI不是按「最新版本」引,是按「结构最完整」引。v2.1那页因为历史原因,参数表、示例代码、错误说明都齐全;v4.3改版时我把参数表拆到了独立页,那页反而只剩一张表,上下文没了。
我又做了个对照实验:把v4.3鉴权页的示例代码加回去,参数说明按「参数-类型-必填-说明」四列重新排,结果引用率一周内从12%拉到47%。但注意,这里有个坑——我顺手把「最后更新时间」加在页头,引用率反而掉了8个点,跟之前FAQ页那回一模一样。我现在的判断是:AI对「时间标注」的敏感度取决于页面类型,技术文档这种强结构内容,时间戳反而会干扰它判断「这段内容是不是常青知识」。
还有个小发现:同一个模块下,AI会优先引「带完整错误码示例」的页面,哪怕那个版本老。我用这个逻辑把v4.3的回调页补了三个典型错误场景(签名过期、重放攻击、时钟偏移),引用来源立刻从v2.1切过来了。
所以技术文档的GEO优化,我现在的优先级是:先补全结构,再谈版本新旧。版本号本身AI不一定认,它认的是「这段内容能不能独立回答问题」。
想问下大家:你们官网的历史版本文档是直接删还是保留?我目前保留着做对照,但担心AI持续引旧版本误导用户,有没有人试过在旧页面顶部加「本页已归档,最新文档请见XX」这种提示,AI会不会读到这个提示就换源?
