什么是 Agent-Native？如何把你的网站升级成面向 AI Agent 的网站
你的网站每天被多少 AI Agent 访问？你可能不知道。Claude、ChatGPT、Gemini、Perplexity 在回答用户问题时会抓取网页内容，AI 编码 Agent 会读取文档来理解你的 API。但你的网站是为人类设计的——导航栏、广告弹窗、JavaScript 渲染——这些对 Agent 来说全是噪音。
Agent-Native 不是某个具体技术，而是一种设计理念：在构建产品和服务时，将 AI Agent 视为一等公民用户，与人类用户同等对待。
这篇文章用一份实操指南告诉你，如何用已有的开放标准把网站升级成 Agent 友好的。
这篇文章涵盖什么
- Agent-Native 的定义和三层含义
- 升级清单：从最简单到最完整
- llms.txt：给 LLM 看的站点地图
- AGENTS.md：给编码 Agent 的 README
- MCP Server：让 Agent 直接调用你的服务
- 其他 Agent 协议和标准
Agent-Native 的三层含义
第一层：内容可读（Content Readable）
Agent 能理解你的内容。不是渲染后的 HTML，而是结构化、干净的文本。你的文档、定价、API 规格能被 Agent 准确提取。
第二层：任务可执行（Action Executable）
Agent 不只是读，还能做。它能调用你的 API、触发操作、获取实时数据。你提供的不是网页，而是能力接口。
第三层：协议兼容（Protocol Compatible）
Agent 通过标准协议与你交互。你不需要为每个 Agent 写专门的集成，一次适配，所有 Agent 都能用。
传统网站： 用户 → 浏览器 → HTML/CSS/JS → 网页
Agent-Native：Agent → 标准协议 → 结构化数据/MCP/API → 执行任务升级清单：四步走
| 步骤 | 做什么 | 难度 | 效果 |
|---|---|---|---|
| 1. llms.txt | 网站根目录放一个 Markdown 概览 | 低 | Agent 理解你的网站 |
| 2. .md 页面 | 为关键页面提供 Markdown 版本 | 低 | Agent 获取干净内容 |
| 3. AGENTS.md | 项目根目录放 Agent 指令文件 | 中 | 编码 Agent 正确工作 |
| 4. MCP Server | 暴露结构化 API 和工具 | 高 | Agent 直接执行操作 |
第一步：添加 /llms.txt
llms.txt 是由 Answer.AI（Jeremy Howard）提出的开放标准，相当于给 LLM 看的站点地图。就像 /robots.txt 告诉搜索引擎怎么爬，/llms.txt 告诉 AI Agent 你的网站有什么、怎么用。
为什么需要它
HTML 页面充满导航、广告、JavaScript，LLM 需要花大量 token 处理噪音。llms.txt 提供一个简洁的 Markdown 概览，Agent 一次读取就能理解你的网站全貌。
格式
放在网站根目录 /llms.txt，纯 Markdown 格式：
# 你的产品名
> 一句话描述你的产品是什么、做什么
更详细的说明段落，帮助 Agent 理解上下文。
## Docs
- [快速开始](https://example.com/docs/quickstart.md): 5 分钟上手指南
- [API 参考](https://example.com/docs/api.md): 完整 API 文档
## Examples
- [示例项目](https://github.com/example/demo): 完整的示例应用
## Optional
- [架构设计](https://example.com/docs/architecture.md): 内部架构说明（次要信息）关键规则
- H1 标题：产品或网站名称（唯一必填项）
- 引用块：一句话摘要
- 正文段落：补充说明
- H2 分节：每个节下列出链接，格式为
[标题](URL): 说明 - Optional 节：标记为可选的信息，上下文窗口不够时可以跳过
谁在用
FastHTML、VitePress、Docusaurus、Drupal 等都已支持。VitePress 和 Docusaurus 有插件自动生成 llms.txt。
第二步：为关键页面提供 Markdown 版本
llms.txt 标准还提出了一个约定：在原始 URL 后面加 .md 就能获取 Markdown 版本。
原始页面：https://example.com/docs/api.html
Agent 获取：https://example.com/docs/api.html.md怎么实现
静态站点：构建时同时生成 HTML 和 Markdown 版本。nbdev 项目已原生支持。
动态站点：添加一个中间件，检测 .md 后缀时返回 Markdown 版本。
文档框架：VitePress 用 vitepress-plugin-llms，Docusaurus 用 docusaurus-plugin-llms，自动生成。
优先级
不需要为所有页面生成 Markdown。优先覆盖：
- API 文档
- 定价页面
- 快速开始/教程
- 变更日志
- FAQ
第三步：添加 AGENTS.md
AGENTS.md 是给编码 Agent 看的 README。如果你的项目是开源的、或者会被 AI 编码工具（Claude Code、Cursor、Codex 等）处理，这个文件必不可少。
已有超过 60,000 个开源项目在使用 AGENTS.md。
和 README.md 的区别
- README.md：给人类看——项目介绍、快速开始、贡献指南
- AGENTS.md：给 Agent 看——构建步骤、测试命令、代码规范、项目约定
示例
# AGENTS.md
## Setup commands
- Install deps: `pnpm install`
- Start dev server: `pnpm dev`
- Run tests: `pnpm test`
## Code style
- TypeScript strict mode
- Single quotes, no semicolons
- Use functional patterns where possible
## Testing instructions
- Run `pnpm test` before committing
- All tests must pass before merging
- Use `pnpm vitest run -t "test name"` for focused testing
## Project structure
- src/components/ — React components
- src/api/ — API route handlers
- src/lib/ — Shared utilities
## Important conventions
- All API responses follow { success: boolean, data: T, error?: string }
- Never modify database migrations directly; create new ones
- Environment variables are validated at startup in src/env.ts支持的 Agent
Claude Code、Cursor、Codex CLI、GitHub Copilot、Gemini CLI、OpenCode、Devin、Windsurf、Aider 等 20+ 编码 Agent 都会读取 AGENTS.md。
第四步：提供 MCP Server
Model Context Protocol（MCP） 是 Anthropic 提出的开放协议，让 AI Agent 通过标准接口调用外部工具和数据源。
如果你的产品提供 API，发布一个 MCP Server 意味着任何支持 MCP 的 Agent（Claude Code、Cursor、Codex、OpenCode 等）都能直接使用你的服务，不需要写专门的集成代码。
MCP Server 能提供什么
- 工具（Tools）：Agent 可以调用的函数（查询数据、执行操作）
- 资源（Resources）：Agent 可以读取的数据（文档、配置）
- 提示（Prompts）：预定义的提示模板
举例：一个支付平台的 MCP Server
Tools:
- create_payment_link(amount, currency) → 支付链接
- get_balance() → 账户余额
- list_recent_transactions(limit) → 最近交易
Resources:
- API 文档
- Webhook 事件列表
Prompts:
- "分析最近的退款趋势"
- "创建一个订阅计划"Agent 只需要配置一行 MCP Server 地址，就能直接调用这些功能。
怎么实现
MCP Server 是一个 JSON-RPC 服务，支持 stdio 和 HTTP 两种传输方式：
- Python：用 FastMCP 或 MCP Python SDK
- TypeScript：用 MCP TypeScript SDK
一个最简的 MCP Server（Python）：
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("my-service")
@mcp.tool()
def get_pricing(plan: str) -> str:
"""Get pricing for a plan"""
prices = {"pro": "$29/mo", "enterprise": "Contact us"}
return prices.get(plan, "Unknown plan")
@mcp.resource("docs://api")
def get_api_docs() -> str:
return "API documentation content..."
mcp.run()其他 Agent 协议
Agent Protocol
AgentProtocol.ai 提供了一套统一的 Agent 通信 API 规范，解决不同 Agent 框架（AutoGPT、LangChain 等）接口不统一的问题。适合构建 Agent 平台的团队。
A2A（Agent-to-Agent）
Google 提出的 Agent 间通信协议，解决多个 Agent 之间如何发现彼此、分配任务、交换结果的问题。
OpenTelemetry GenAI
为 AI Agent 提供标准化的可观测性——追踪每次工具调用、token 消耗、会话状态。用于生产环境的 Agent 监控。
检查清单：你的网站 Agent-Native 了吗
基础（30 分钟内完成）
- 根目录有
/llms.txt - 关键页面有
.md版本 -
robots.txt没有阻止 Agent 访问 - 网站内容可以被 curl 获取（不是纯 JS 渲染）
中级（1-2 天）
- API 文档有 OpenAPI/Swagger 规范
- 定价信息以结构化数据提供
- 如果是开源项目，有 AGENTS.md
- 文档站有搜索 API
高级（1-2 周）
- 提供 MCP Server
- 结构化输出（JSON API）
- Webhook 支持事件驱动
- Agent 访问统计和分析
为什么要做这件事
不做会怎样？不会怎样。就像 2005 年你可以不做 SEO，2010 年你可以不做移动端适配——但做了的人获得了先发优势。
做 Agent-Native 升级的实际收益：
- AI 搜索引擎优化：ChatGPT、Perplexity、Gemini 回答用户问题时引用你的内容
- 编码 Agent 集成：Claude Code、Cursor 用户自动获取你的最新文档
- 开发者体验：API 用户通过 Agent 直接调用你的服务，降低学习成本
- 竞争优势：当用户问「有什么好用的 X 工具」，Agent 会推荐那些它理解得最好的
今天的互联网流量中，AI Agent 的占比正在快速增长。为 Agent 优化，本质上是在为一个快速增长的用户群体做 SEO。
作者: itech001 来源: 公众号：AI人工智能时代(the-ai-era) 网站: https://www.theaiera.top/ 关注每日最新AI新闻和技术博客，主页有更多的文章的AI 技术参考：https://www.theaiera.top
本文首发于 AI人工智能时代，转载请注明出处。
