惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

宝玉的分享
宝玉的分享
B
Blog RSS Feed
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
MyScale Blog
MyScale Blog
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
S
SegmentFault 最新的问题
Y
Y Combinator Blog
月光博客
月光博客
IT之家
IT之家
T
Tailwind CSS Blog
Last Week in AI
Last Week in AI
L
LangChain Blog
博客园_首页
MongoDB | Blog
MongoDB | Blog
P
Proofpoint News Feed
博客园 - Franky
WordPress大学
WordPress大学
云风的 BLOG
云风的 BLOG
M
MIT News - Artificial intelligence
V
Visual Studio Blog
小众软件
小众软件
博客园 - 叶小钗
博客园 - 三生石上(FineUI控件)
N
Netflix TechBlog - Medium

博客园 - iTech

7万星的AI交易框架:让大模型模拟投行多空辩论,自动做交易决策 71000颗星的AI交易团队:让大模型模拟投行分工,自动做交易决策 13400颗星的开源项目:输入一句话,AI全自动帮你做短视频 102颗星的沙盒:当AI学会自己写代码、跑测试、做部署 AI 技术日报 - 2026-05-08 29k 星的 PageIndex:不用向量数据库,靠推理就能做 RAG 每天花两小时刷信息?这个开源项目帮你全自动搞定 读源码像读小说?试了 DeepWiki 和 Zread,我再也不想裸读 GitHub 了 Matt Pocock 开源的这套 .claude 技能,为什么让工程师集体上头? Cursor Team Kit:Cursor 官方团队在用的 17 个 AI 工作流 AI 技术日报 - 2026-05-07 AI 技术日报 - 2026-05-06 AI 技术日报 - 2026-05-05 Anthropic CEO 说 12 个月内程序员要失业,我扒完他的底牌,发现事情没那么简单 把工程师的肌肉记忆装进 Claude Code,这个 4300 Star 的项目我后悔没早用 AI 技术日报 - 2026-05-04 AI 技术日报 - 2026-05-03 AI 技术日报 - 2026-05-02 六大 Agent 框架横评:谁支持 Skills?谁能自动创建 Agent?MCP 呢? Wechatsync:一个 Chrome 插件,一键把文章同步到 31 个平台 LangChain 开源了 Open SWE:Stripe、Ramp、Coinbase 内部都在造的编程 Agent Cockpit:把 Claude Code 从终端里搬出来,装进浏览器 Cursor 把自家的 AI Agent 开放了:写几行 TypeScript 就能调 Cursor 干活 AI 技术日报 - 2026-05-01 AI 写代码每次结果都不一样?Archon 用 YAML 工作流把 AI 编程变成流水线 AI 写代码比你快了,但你还是得学编程——只不过学法得换 腾讯的龙虾特工队:4 个 AI Agent 同日更新,全家桶正式成型 Agno 不做更聪明的 Agent,它要把所有 Agent 框架包进同一个操作系统 Hermes Agent 终于有了像样的 Web 界面,而且还支持远程访问 Datawhale 出了一套 29 学科知识地图,把 AI 的底牌全掀了
什么是 Agent-Native?如何把你的网站升级成面向 AI Agent 的...
iTech · 2026-05-24 · via 博客园 - iTech

你的网站每天被多少 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): 内部架构说明(次要信息)

关键规则

  1. H1 标题:产品或网站名称(唯一必填项)
  2. 引用块:一句话摘要
  3. 正文段落:补充说明
  4. H2 分节:每个节下列出链接,格式为 [标题](URL): 说明
  5. 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 两种传输方式:

一个最简的 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 升级的实际收益:

  1. AI 搜索引擎优化:ChatGPT、Perplexity、Gemini 回答用户问题时引用你的内容
  2. 编码 Agent 集成:Claude Code、Cursor 用户自动获取你的最新文档
  3. 开发者体验:API 用户通过 Agent 直接调用你的服务,降低学习成本
  4. 竞争优势:当用户问「有什么好用的 X 工具」,Agent 会推荐那些它理解得最好的

今天的互联网流量中,AI Agent 的占比正在快速增长。为 Agent 优化,本质上是在为一个快速增长的用户群体做 SEO。


作者: itech001
来源: 公众号:AI人工智能时代
网站: https://www.theaiera.cn/
每日分享最前沿的AI新闻资讯和技术研究。

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