什么是 Agent-Native？如何把你的网站升级成面向 AI Agent 的网站

2026-05-24T09:00:00+08:00

Agent-Nativellms.txtAGENTS.mdMCPAI 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人工智能时代网站: https://www.theaiera.cn/ 每日分享最前沿的AI新闻资讯和技术研究。

本文首发于 AI人工智能时代，转载请注明出处。