当搜索者从人类变成 AI Agent，内容策略必须重做。

---

一个真实的问题

前几天我在 Perplexity 搜一个技术方案，AI 引用了我们团队写的一篇文档。点进去一看——摘要全错，关键参数丢了，甚至连结论都反了。

不是 Perplexity 不行。是我们的内容，根本不是给 AI 读的。

我们花了大量精力做 SEO：关键词布局、内链策略、meta description 精雕细琢。但这些都是给 Google 爬虫和人类用户设计的。当"读者"变成一个 AI Agent，它不会看你精心排版的 hero banner，不会滑动你的轮播图，不会在弹窗里找"跳过"按钮。

它只会做一件事：读你的内容，然后试图理解它。

问题来了——它能读懂吗？

搜索引擎的权力交接

先看一个趋势：

这个流程变化意味着什么？

Google 时代，你的目标是排到第一页。用户来了，自己读、自己判断。你的内容写得"还行"就够用——标题吸引人、开头有悬念、内容凑够字数。

Agent 时代，AI 直接替用户读你的页面、替用户判断、替用户总结。你的内容必须能被机器准确理解和提取。如果 Agent 在你的页面上找不到关键信息，它不会犹豫——它会转向下一个来源。

你的竞争对手不再只是同行业的其他网站，还包括任何一个 Agent 能准确读取的页面。

Agent 怎么"读"你的内容？

要优化，先理解 Agent 的行为模式。经过大量观察和实践，Agent 读取内容有三个核心特征：

1. 只读前 N 行

这不是猜测，是 Agent 框架的实际行为。为了控制上下文窗口（context window），大多数 Agent 在读取文件时会设置截断：

• 只读前 100 行
• 只读前 8KB
• 只读前 2000 tokens

这意味着如果你的关键信息埋在文章第三段之后、或者在折叠的 <details> 标签里、再或者藏在 JavaScript 渲染的 Tab 切换后面——Agent 根本看不到。

2. 依赖链接层级导航

人类打开一个文档站，会看到侧边栏、面包屑、搜索框。Agent 看到的只有——链接。

它从首页开始，顺着链接一层一层往下找。如果你的页面结构混乱，链接层级不清晰，Agent 就像走迷宫。

对比一下：

人类视角	Agent 视角
看到漂亮的侧边栏导航	看到一堆 <a> 标签
搜索框输入关键词找内容	没有搜索功能，只能遍历链接
知道"快速开始"就是入门指南	不知道，除非链接文字说清楚
能从排版判断信息层级	只能从 HTML 结构判断

3. "被告知"和"自己发现"的差距

这是一个被严重低估的点。

当 Agent 被直接告知"认证配置在 /docs/auth"时，它会精准定位。当它需要自己翻找时，可能要在 5 个页面中搜索，消耗大量 token，还可能找错。

在 Agent 的世界里，发现成本直接等于可靠性。信息越容易被发现，被正确使用概率越高。

怎么优化？Sentry 的实战

Sentry 的 CTO David Cramer 最近详细分享了他们的实践。核心机制很简单——Content Negotiation（内容协商）。

原理

当 HTTP 请求头包含 Accept: text/markdown 时，你基本可以确定：来的是一个 AI Agent。

人类和 Agent，同一条 URL，不同的响应。两全其美。

Sentry 的三个具体案例

案例一：文档站

Agent 访问 Sentry 文档时，返回的不是带导航、搜索框、侧边栏的 HTML，而是纯 Markdown：

# Sentry Documentation

Sentry 是一个面向开发者的应用监控平台...

## 核心功能
- **错误监控**：捕获完整的堆栈信息
- **性能追踪**：跨服务追踪请求链路
- **会话回放**：查看真实用户操作路径
...

关键优化：

• ✅ 去掉导航、面包屑等浏览器专属元素
• ✅ 保留清晰的标题层级（#、##）
• ✅ 信息密度高，无废话
• ❌ 不需要 hero banner、CTA 按钮、用户评价模块

案例二：产品主页

Agent 访问 sentry.io 时，最蠢的做法是返回一个登录页面。Sentry 做了什么？返回了 Agent 真正需要的东西——程序化接入方式：

# Sentry

你访问了 Web UI，这是给人类用的。
作为 Agent，你可能需要以下接入方式：

## MCP Server（推荐）
```json
{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

CLI

查询 issues、分析错误：https://cli.sentry.dev

API

REST API 文档：https://docs.sentry.io/api

这太聪明了。Agent 来了，直接给接口，不给 HTML。这才是"Agent-first"的思维方式。

**案例三：开源项目**

Sentry 的开源项目 Warden 做了更激进的优化：Agent 一次请求就能拿到完整的启动引导，包括功能说明、架构、快速开始命令。不需要翻 README、不需要看 CONTRIBUTING.md、不需要在多个页面间跳转。

**一次请求，完整上下文。**

## 实操：优化三原则

结合 Sentry 的经验和我们自己踩过的坑，总结出三条原则：

```mermaid
graph TB
    subgraph Agent-First 内容优化
        P1["原则一：顺序为王"]
        P2["原则二：精简到极致"]
        P3["原则三：链接即地图"]
    end
    
    P1 --> P1a["最重要的信息放最前面"]
    P1 --> P1b["前 500 字 = 摘要"]
    P1 --> P1c["结论先行，细节在后"]
    
    P2 --> P2a["去掉装饰性内容"]
    P2 --> P2b["去掉导航/JS/弹窗"]
    P2 --> P2c["Markdown > HTML"]
    
    P3 --> P3a["索引页 = 站点地图"]
    P3 --> P3b["链接文字要语义化"]
    P3 --> P3c["层级不超过 3 层"]

原则一：顺序为王

Agent 从上到下读。第一屏决定它对整个页面的理解。

• ❌ “欢迎来到我们的产品文档，我们是一家成立于 2019 年的公司…”
• ✅ “这是一个 XX 工具，用于解决 YY 问题。核心功能：A、B、C。快速开始：…”

把结论放前面，把细节放后面。老派的新闻写作原则，在 Agent 时代焕发新生。

原则二：精简到极致

Agent 不关心你的品牌故事。它关心事实。

Markdown > HTML。原因很简单：

维度	HTML	Markdown
Token 消耗	高（标签、属性、样式）	低（纯文本 + 简单标记）
解析准确率	容易被导航/脚本干扰	结构清晰，几乎不会误读
Agent 友好度	❌	✅

同样的内容，Markdown 格式可以节省 40-60% 的 token，同时提高解析准确率。

原则三：链接即地图

Agent 靠链接导航。你的索引页就是它的地图。

• 确保首页/索引页有清晰的、完整的内容目录
• 链接文字要语义化（用 /docs/auth 而不是 /page?id=42）
• 层级不要超过 3 层——Agent 的耐心和你的 token 预算一样有限

国内场景：这跟我们有什么关系？

你可能在想：Sentry 是面向全球开发者的，国内环境不一样。

不一样吗？

看看我们身边的 AI 搜索产品：

• Kimi（月之暗面）— 已经在大量抓取和引用中文技术内容
• 豆包（字节跳动）— 内置搜索能力，直接总结网页内容
• 秘塔搜索 — 专门做 AI 搜索的产品
• 通义千问 — 阿里的 AI 搜索集成

它们的工作方式和 Perplexity 如出一辙：读取你的页面 → 理解内容 → 总结给用户。

更重要的趋势是 MCP（Model Context Protocol） 的兴起。这个协议让 AI Agent 不再只是"读网页"，而是可以直接调用你的 API、查询你的数据库、操作你的工具。

两条路并行：Agent 可以直接调 API 拿数据，也可以读你的内容站获取上下文。两条路都需要你做好准备。

谁会受益，谁会被淘汰

会受益的：

• 文档结构清晰的开源项目（Agent 最容易推荐这类内容）
• 提供结构化 API 的 SaaS 产品（MCP 接入 = Agent 直接可用）
• 技术博客内容扎实的个人/团队（深度内容 Agent 会优先引用）
• 早期就做 Content Negotiation 优化的网站

会被淘汰的：

• 靠关键词堆砌的 SEO 农场（Agent 不看关键词密度）
• 信息藏在折叠/弹窗/Tab 后面的页面（Agent 读不到）
• 结构混乱、链接死链多的文档站（Agent 导航失败 = 放弃）
• 只能渲染 HTML、没有数据层的网站（Agent 没有高效的数据获取方式）

立即行动：3 件你可以现在就做的事

1. 用 Agent 的视角看看你的网站

# 模拟 Agent 请求
curl -H "Accept: text/markdown" https://your-website.com

# 如果返回的还是 HTML，说明你还没做优化
# 如果返回的是一堆导航和脚本，说明优化不够

2. 检查关键页面的前 500 字

打开你最重要的 5 个页面，数一下前 500 字里有没有关键信息。如果开头是品牌故事和欢迎语——该改了。

3. 给项目加一个 Agent 友好的入口

最简单的起步方式：在网站根目录放一个 llms.txt，告诉 Agent 你的站点结构和核心内容。虽然这个方案被一些人质疑，但作为"被直接告知"的入口，它确实有效。

更进一步的方案是实现 Content Negotiation——根据请求头返回不同格式。Nginx 或 Next.js 都可以轻松实现。

---

结语

Agent-first 不是取代 SEO，而是在 SEO 之上增加了一个新的维度。

过去十年，我们学会了为 Google 写内容。接下来十年，我们要学会为 AI Agent 写内容。

好消息是，优化的方向其实很清晰：更好的结构、更少废话、更准确的信息表达。这些不仅是 Agent 喜欢的，也是人类读者一直喜欢的。

只是现在，如果你不做，Agent 就会去别的地方找答案。

---

如果这篇文章对你有帮助：
• 👍 点赞支持
• 🔖 收藏备用
• 📤 分享朋友

下期见！
关注公众号【架构之旅】，第一时间获取AI相关实战教程，错过不再补～