跳转到主要内容
ChatGPT、Perplexity 和 Google AI Overviews 等 AI 驱动的工具越来越多地直接回答用户的问题,引用来源而非列出链接。当开发者问”如何使用[你的产品]进行身份验证”时,一个优化良好的文档页面会被引用在答案中。而一个结构不佳的页面会被跳过——即使它在传统搜索中排名很好。 Generative Engine Optimization (GEO) 是一种结构化内容的实践,使 AI 系统能够理解、信任并准确引用这些内容。

GEO 与 SEO 有何不同

传统 SEO 针对排名和链接页面的搜索引擎进行优化。GEO 针对在生成的答案中阅读、总结和引用页面的 AI 系统进行优化。 两者的机制在以下重要方面有所不同:
SEOGEO
目标在搜索结果中排名在 AI 生成的答案中被引用
关键信号反向链接、关键词、页面权威性内容准确性、结构、直接性
用户行为点击链接阅读 AI 生成的答案
格式偏好任何结构良好的内容可扫描的、回答问题的内容
好消息是:基本原则高度重叠。准确、结构良好且直接回答问题的内容在两者中都表现出色。GEO 更多的是关于写作的清晰度,而非技巧。

AI 系统如何决定引用什么

AI 答案引擎基于几个关键因素评估内容: 直接性。 AI 系统优先选择立即回答问题的内容。一个在三段上下文之后才给出答案的页面,比起直接给出答案的页面,更难获得引用。 准确性和信任信号。 AI 系统倾向于来自权威来源且看起来事实可靠的内容。对于文档而言,这意味着技术准确性、一致的版本控制以及与产品实际功能相匹配的内容。 结构清晰度。 逻辑组织的内容——具有有意义的标题、列表和代码块——更容易被 AI 系统正确解析和摘录。 具体性。 模糊的高层次内容(“此功能灵活而强大”)不如具体详细的内容(“当请求超过每分钟 100 次的速率限制时,此 endpoint 返回 429 状态码”)容易被引用。

编写 AI 系统可以引用的内容

以答案开头

组织每个部分,使最重要的信息排在最前面。向 AI 工具提问的用户想要直接的答案——不要铺垫,不要上下文,不要在重点之前加注意事项。

使用与问题匹配的标题

将 H2 和 H3 标题写成用户提出的问题,而非主题标签。AI 系统在决定展示什么内容时,会将用户查询与标题文本进行匹配。

对数字、限制和示例要具体

模糊的描述不会被引用。具体、准确的细节会被引用。AI 系统可以准确引用”速率限制:每个 API key 每分钟 100 个请求”。而”我们的 API 有速率限制”不会给 AI 任何有用的可引用内容。 对于每个配置选项、参数或行为:
  • 说明确切的值或范围
  • 描述在边界处会发生什么
  • 展示一个具体的代码示例

保持术语一致

AI 系统在整个页面中构建上下文。如果你将同一事物交替称为”API key”、“access token”和”API token”,AI 的摘要可能会使用错误的术语,或者对这些是否是同一事物产生困惑。一致的术语——每个概念一个名称,始终使用——有助于 AI 系统准确表示你的内容。

为 AI 解析进行格式化

使用连续、不跳级的标题层次结构

不要从 H2 直接跳到 H4。AI 系统使用标题层次结构来理解主题之间的关系。扁平、一致的结构更容易被正确解析。

为所有代码块添加标签

始终在代码块上声明编程语言。这有助于 AI 系统理解它们正在阅读的内容,并为用户的上下文展示正确的示例。

为图像和图表编写替代文本

AI 系统无法看到图像。如果图表是某个概念的主要解释,请添加传达相同信息的文本描述。描述图表内容的替代文本——而不仅仅是”架构图”——能给 AI 系统提供可用的信息。

使用具体引用而非代词

写”API key”而非”它”或”这个值”。AI 系统会摘录内容并失去周围的上下文。具体的名词引用在被摘录时仍然准确;代词则会变得模糊。

Mintlify 的 GEO 配置

添加描述性的页面元数据

页面标题和描述是 AI 系统用来理解页面主题的最重要信号之一。编写它们时,就像在回答”这个页面帮助用户做什么?“这个问题一样。

控制索引设置

默认情况下,Mintlify 会索引包含在 docs.json 导航中的页面。要将隐藏页面包含在 AI 助手上下文和搜索中:
docs.json

LLMs.txt

Mintlify 会自动为你的文档生成 llms.txt 文件。LLMs.txt 的工作方式类似于传统搜索中的 sitemap.xml——它为 AI 系统提供文档的结构化索引。无需任何配置。 你可以通过在文档 URL 后附加 /llms.txt 来查看你的 LLMs.txt。

在 robots.txt 中允许 AI 代理

你的 robots.txt 文件控制哪些机器人可以抓取你的网站。如果它屏蔽了 AI 用户代理,ChatGPT、Claude 和 Perplexity 等工具将无法读取你的文档,也无法在回答中引用它。 Mintlify 自动生成的 robots.txt 默认允许所有爬虫,并包含 Content-Signal 指令,可让 AI 工具将你的文档用于模型训练、搜索索引和 AI 回答生成。如果你使用自定义 robots.txt 文件,请确保它不会屏蔽 AI 代理。最常见的 AI 用户代理包括:
  • GPTBotOAI-SearchBotChatGPT-User (OpenAI)
  • ClaudeBotClaude-User (Anthropic)
  • PerplexityBot (Perplexity)
  • Google-Extended (Gemini)
屏蔽所有爬虫的 robots.txt 也会屏蔽 AI 代理:
Bad — blocks all AI agents
要屏蔽特定爬虫同时允许 AI 代理,只需定向限制你想屏蔽的机器人:
Good — allows AI agents
运行 mint score 检查你网站的 robots.txt 是否允许 AI 代理。当没有 AI 用户代理被屏蔽时,robotsTxtAllowsAI 检查即为通过。

测试 AI 工具如何呈现你的文档

定期测试 AI 工具是否准确引用了你的文档。 在 ChatGPT、Perplexity 和 Claude 中提出关于你产品的具体问题:
  • “如何使用[你的产品]验证 API 请求?”
  • “当我超过[你的产品]的速率限制时会发生什么?”
  • “向我展示如何处理[你的产品] API 中的错误。”
检查回答中的以下内容:
  • 你的文档是否被引用
  • 被引用的内容是否准确
  • 代码示例是否正确
  • AI 是否推荐了正确的方法
当 AI 工具给出关于你产品的错误答案时,这通常表明你的文档存在歧义、缺失或矛盾,而不是 AI 本身出了问题。

常见问题

不会。传统搜索仍然带来大量流量,许多用户更喜欢点击进入文档而非阅读 AI 生成的摘要。GEO 和 SEO 是互补的——结构良好、准确且直接回答问题的文档在两者中都表现出色。这些实践相互强化。
在很多情况下比 SEO 更快。Perplexity 和 ChatGPT 等 AI 系统比传统搜索引擎更频繁地抓取和索引内容。内容清晰度和结构的改进可以在几天到几周内出现在 AI 生成的答案中。也就是说,AI 系统也会考虑域名权威性和链接信号,这些需要更长时间来建立。
Google AI Overviews 使用与 Google Search 相同的信号,并对直接回答特定查询的内容给予额外权重。已经在 Google Search 中针对某个查询排名靠前的页面,更有可能出现在同一查询的 AI Overviews 中。GEO 的主要实践——以答案开头、具体细节、清晰结构——在这里同样适用。
不应该。对人类来说清晰直接的内容,对 AI 系统来说同样清晰直接。以牺牲人类可读性为代价专门为 AI 优化是适得其反的,往往会产生既不好读也不容易被引用的内容。首先为你的用户写作;GEO 自然而然地源于良好的技术写作。
LLMs.txt 是一种约定——类似于 robots.txt——用于为 AI 系统提供文档的结构化索引。Mintlify 会自动生成它。你不需要配置它。你可以在 https://your-docs-domain.com/llms.txt 查看你的 LLMs.txt 文件。