[{"data":1,"prerenderedAt":243},["ShallowReactive",2],{"blog-ai-agent-docs-geo":3,"blog-prev-ai-agent-docs-geo":92,"blog-next-ai-agent-docs-geo":155},{"id":4,"title":5,"author":6,"body":7,"canonical":77,"category":78,"cover":77,"date":79,"description":80,"draft":81,"extension":82,"keywords":77,"meta":83,"navigation":84,"noindex":81,"ogImage":77,"path":85,"seo":86,"seoDescription":77,"seoTitle":77,"stem":87,"tags":88,"updated":77,"__hash__":91},"blog\u002Fblog\u002Fai-agent-docs-geo.md","AI 产品文档怎么写，才会被别的 AI 引用","元析智能",{"type":8,"value":9,"toc":69},"minimark",[10,14,19,22,25,29,32,35,39,42,45,51,54,57,60,63,66],[11,12,13],"p",{},"AI 产品的文档，读者不止是人，还有别的 AI。2025 年 10 月到 2026 年 2 月，我们给一个 agent 编排平台做文档改造，重点是让它更容易被回答引擎引用，四个月里被引用的次数从每周 3 次左右到 15 次以上。",[15,16,18],"h2",{"id":17},"位置一定义段","位置一：定义段",[11,20,21],{},"每个核心概念第一段必须是一句可独立引用的话。比如“工具调用（tool call）指模型在生成过程中调用外部函数并读取返回值的过程”。这句话脱离上下文也成立，AI 引用时不会失真。",[11,23,24],{},"很多文档的开头是“在本节中我们将介绍……”，这种句子对 AI 没有任何价值。我们删了客户文档里 30 多处这种过渡句。",[15,26,28],{"id":27},"位置二能力边界","位置二：能力边界",[11,30,31],{},"AI 引用你的产品时，最常回答的问题是“XX 能做什么、不能做什么”。所以文档里要有一节明确写边界：支持哪些模型、上下文上限多少、并发限制、哪些场景不适用。",[11,33,34],{},"我们把这个部分做成表格，每行一个维度，给具体数字。这张表被引用的频率最高，因为它能被直接拆成答案。我们每季度核对一次数字，别让过期的上限被引用出去。",[15,36,38],{"id":37},"位置三错误与失败模式","位置三：错误与失败模式",[11,40,41],{},"AI 产品一定会失败，文档写清失败模式反而加分。“工具调用超时怎么处理”“模型返回格式不合法怎么办”“上下文超长时丢哪部分”，这三类问答几乎每个用户都会问，也是 AI 最容易被问到的。",[11,43,44],{},"写法是问答体：问题一句话，答案三句以内给结论，再展开。",[11,46,47],{},[48,49,50],"strong",{},"位置四：对比和替代",[11,52,53],{},"文档里加一节“和其他方案的区别”。注意是区别，不是贬低。写清适用场景的边界，比如“如果你只需要简单的链式调用，用脚本就行，不需要这个平台”。",[11,55,56],{},"这一节在 AI 回答里出现率高得惊人。用户问“XX 和 YY 哪个好”，AI 需要的是中立的差异描述，不是广告。",[15,58,59],{"id":59},"一个判断标准",[11,61,62],{},"写完一段文档，问自己：这段话能不能被单独摘出来，作为某个问题的答案？能，就达标；不能，就是给人看的上下文，AI 用不上。",[11,64,65],{},"还有一件事要排进流程：能力边界那节挂进发版检查清单，版本上线必须同步改。AI 产品迭代快，被引用出去的旧数字比没被引用更麻烦。",[11,67,68],{},"这件事的收益不在点击，在曝光。被 AI 提到 100 次，可能只带来 5 次访问，但那 5 次是带着信任来的。我们追踪过一个客户，从 AI 引用进入的访客，试用转化率是自然搜索的 2.3 倍。",{"title":70,"searchDepth":71,"depth":71,"links":72},"",2,[73,74,75,76],{"id":17,"depth":71,"text":18},{"id":27,"depth":71,"text":28},{"id":37,"depth":71,"text":38},{"id":59,"depth":71,"text":59},null,"GEO","2026-02-12","做 AI 工具的都希望被回答引擎推荐，但文档写成营销腔就没人引用。我们改了定义段、能力边界、失败模式、对比四类内容，一个 agent 平台被引用的次数翻了 5 倍。",false,"md",{},true,"\u002Fblog\u002Fai-agent-docs-geo",{"title":5,"description":80},"blog\u002Fai-agent-docs-geo",[78,89,90],"AI 产品","文档写作","QDcm5pO48_8payqlI044h0SroPAi4HbDXdEJYGhBYHU",{"id":93,"title":94,"author":6,"body":95,"canonical":77,"category":143,"cover":77,"date":144,"description":145,"draft":81,"extension":82,"keywords":77,"meta":146,"navigation":84,"noindex":81,"ogImage":77,"path":147,"seo":148,"seoDescription":77,"seoTitle":77,"stem":149,"tags":150,"updated":77,"__hash__":154},"blog\u002Fblog\u002Ftechnical-author-credentials.md","技术作者的履历怎么写：证书、项目、可查痕迹",{"type":8,"value":96,"toc":138},[97,100,104,107,110,114,117,120,123,126,129,132,135],[11,98,99],{},"技术作者的履历不用写长，但每一句都得能被查。我们审过 30 多个软件站的作者页，能真正查证的履历不到一半，大多数写的是\"多年互联网经验\"\"熟悉分布式架构\"这类谁也验证不了的话。",[15,101,103],{"id":102},"证书列三个以内带编号","证书：列三个以内，带编号",[11,105,106],{},"证书对技术读者有信号价值，前提是具体。写法是机构加年份，比如\"2023 年通过 CKA 认证\"\"2022 年 AWS 解决方案架构师\"。有编号的可以放编号，没有编号就别硬凑。",[11,108,109],{},"列三个以内。一堆证书堆上去，反而像培训机构的广告。如果作者没有证书，不如空着，用项目经历补，别硬编。",[15,111,113],{"id":112},"项目经历写到你改了什么这一层","项目经历：写到\"你改了什么\"这一层",[11,115,116],{},"这是最容易写虚的地方。\"参与过大型电商系统的架构设计\"没有信息量，读者不知道你做了什么。改成\"把订单系统的 P99 从 800 毫秒降到 220 毫秒，主要动作是把两处同步调用改成异步\"，信息量立刻不一样。",[11,118,119],{},"要有数字，也要有动作。数字说明结果，动作说明你真的在现场。写不出动作的项目，多半不是你亲手做的，这种就别写进履历。",[11,121,122],{},"2025 年 8 月我们改过一个客户的技术作者页，把原来那三段\"熟悉\u002F精通\"式的描述全删了，换成三个具体项目，每个项目写清楚问题、动作、结果。改完之后，这个作者的文章在站内的停留时间从 50 秒涨到 1 分 40 秒。数据不是立刻涨的，是两个月后慢慢起来的。",[15,124,125],{"id":125},"可查痕迹放哪几个平台",[11,127,128],{},"优先级从高到低：GitHub、技术社区主页（知乎、掘金、V2EX）、公开演讲或会议页面、开源项目贡献记录、专利和论文。",[11,130,131],{},"GitHub 对开发者工具类公司最重要，因为代码和 issue 记录做不了假。技术社区主页次之，看的是持续输出。演讲和会议页面适合有行业积累的作者，能直接证明\"这个人在圈子里\"。",[11,133,134],{},"这些链接要双向：作者页指向账号，账号资料里也写清楚在哪家公司、负责什么。单向的链接说服力弱一半。",[11,136,137],{},"履历这件事，被验证一次就建立了信任，被拆穿一次就全废了。宁短勿虚。",{"title":70,"searchDepth":71,"depth":71,"links":139},[140,141,142],{"id":102,"depth":71,"text":103},{"id":112,"depth":71,"text":113},{"id":125,"depth":71,"text":125},"内容运营","2026-02-11","技术博客的作者页最怕写成简历。这篇讲三样东西怎么写才可验证：证书列几个、项目经历写到什么颗粒度、公开痕迹放哪几个平台，附一个改坏了的反面例子。",{},"\u002Fblog\u002Ftechnical-author-credentials",{"title":94,"description":145},"blog\u002Ftechnical-author-credentials",[151,152,153],"作者信号","技术写作","E-E-A-T","7oQuNYoIEElrRCfxLs86SRl1mf5aXNJJiP0LRgAeWCs",{"id":156,"title":157,"author":6,"body":158,"canonical":77,"category":143,"cover":77,"date":232,"description":233,"draft":81,"extension":82,"keywords":77,"meta":234,"navigation":84,"noindex":81,"ogImage":77,"path":235,"seo":236,"seoDescription":77,"seoTitle":77,"stem":237,"tags":238,"updated":77,"__hash__":242},"blog\u002Fblog\u002Fwechat-article-search-indexing.md","公众号文章怎么写才被微信搜一搜收录",{"type":8,"value":159,"toc":224},[160,163,166,169,172,175,178,181,184,187,191,194,197,200,203,206,209,212,215,218,221],[11,161,162],{},"公众号文章被搜一搜收录，关键不在发布后，在发布前。我们发了 96 篇原创，收录率 71%，把可复制的动作拆成清单，照着做能少走很多弯路。",[15,164,165],{"id":165},"收录和排名是两件事",[11,167,168],{},"先分清。收录是文章进了搜一搜的索引，能搜到；排名是搜某个词时排第几。收录是基础，没收录就谈不上排名。",[11,170,171],{},"我们统计过：96 篇里收录 68 篇，收录的里面能在目标词前 20 找到的只有 29 篇。也就是说，收录不等于有流量，但没收录一定没流量。",[15,173,174],{"id":174},"发布前的四个动作",[11,176,177],{},"第一，账号原创比例要够。搜一搜看账号历史，原创比例低的号，新文章收录慢。我们一个新号前 10 篇全是原创，第 8 篇开始收录速度明显变快。",[11,179,180],{},"第二，标题里放用户会搜的词。不要文艺标题，不要问句。我们测试过：\"我们如何把 API 响应时间降了 40%\"收录了但没排名；改成\"API 响应慢怎么优化：5 个排查步骤\"后，一周内进了前 10。",[11,182,183],{},"第三，正文前 200 字把核心信息说清。搜一搜抓取正文前段做匹配，别在前面铺场景。第一段直接给结论，第二段给方法。",[11,185,186],{},"第四，发布时间选工作日白天。我们对比过，周二到周四上午 9 点到 11 点发布的文章，48 小时内收录率比其他时段高约 15 个百分点。样本不大，但三次测试方向一致。",[15,188,190],{"id":189},"发布后的-48-小时","发布后的 48 小时",[11,192,193],{},"这是传播数据的关键窗口。转发到相关的群、让同事点在看、在评论区提一个问题引导互动，都是有效动作。",[11,195,196],{},"不要做的事：买阅读量、刷在看。微信对异常传播识别很严，我们见过一个号刷了两个月被降权，之后再没起来。",[15,198,199],{"id":199},"一个对照实验",[11,201,202],{},"这个实验是去年 12 月做的。当时两个号各发一篇，内容同一套素材，只换标题和首段，结果差得让我们重新写了发布规范。",[11,204,205],{},"同一个选题写两篇，A 版标题是\"关于 API 监控的一些思考\"，B 版是\"API 监控怎么做：3 个指标和 1 个告警阈值\"。",[11,207,208],{},"两篇内容 80% 相同。A 版收录用了 6 天，收录后搜目标词在第 40 名开外；B 版 2 天收录，第 9 名。差异全在标题和首段。",[15,210,211],{"id":211},"常见问题",[11,213,214],{},"问：老文章能不能改标题重新发？不能，改标题不会重新触发收录，反而可能影响已有排名。要重做就新发一篇，内容重写。",[11,216,217],{},"问：视频号内容算不算？算，搜一搜会展示视频号内容，但排名逻辑和图文不一样，我们还没跑出稳定结论，先不写。",[15,219,220],{"id":220},"一句判断",[11,222,223],{},"搜一搜不是百度的补充，是另一套玩法。把它当\"微信内的搜索引擎\"来做，别把公众号当官网博客。",{"title":70,"searchDepth":71,"depth":71,"links":225},[226,227,228,229,230,231],{"id":165,"depth":71,"text":165},{"id":174,"depth":71,"text":174},{"id":189,"depth":71,"text":190},{"id":199,"depth":71,"text":199},{"id":211,"depth":71,"text":211},{"id":220,"depth":71,"text":220},"2026-02-13","公众号文章被搜一搜收录，关键不在发布后，在发布前：账号原创比例、标题关键词、正文前 200 字、发布时间。我们从 2025 年 3 月起发了 96 篇原创，收录率 71%，把可复制的动作拆成了清单。关键动作只有四个，照着做收录能快三到四天。",{},"\u002Fblog\u002Fwechat-article-search-indexing",{"title":157,"description":233},"blog\u002Fwechat-article-search-indexing",[239,240,241],"微信搜一搜","公众号","收录","0e7w9bxLVMOL7UmedAD1PyVs9qYjaiw-mI3iAy_KO38",1794088108440]