智能体体验指南

Web 是为人而建的——每个按钮、每个表单、每个导航菜单都默认用户是有眼睛和双手的人。但增长最快的用户群体不是人类，而是 AI 智能体。每个网站已经存在一种智能体体验，问题只在于它是好是坏。

正如 UX 教我们为用户设计、DX 教我们为开发者设计，AX（智能体体验） 是为 AI 智能体设计的学科——它们浏览网站、调用 API、阅读文档、代表人类完成任务。本指南是一本实用的开源手册，教你如何做好这件事。

为什么需要本指南

• ora.ai 告诉你你在哪里——它对数千个网站评分并排名智能体就绪度。
• axd.md 告诉你目标是什么——它定义了 12 条原则和 15 个原语。
• agentexperience.ax 策划对话和文章关于 AX 运动。

本指南告诉你怎么到达——具体的、可操作的步骤，附带代码示例、模式和反模式。

六个阶段

1. 可发现性 — 智能体能找到你吗？
2. 身份标识 — 智能体能理解你的产品吗？
3. 认证与访问 — 智能体能认证并执行操作吗？
4. 集成 — 管道就绪了吗？
5. 错误与恢复 — 智能体能自愈吗？
6. 终端用户体验 — 人类能通过智能体交互吗？

快速开始

1. 添加 /llms.txt 到网站根目录。
2. 返回类型化错误，从每个 API 端点返回带重试指引的错误。
3. 让智能体认证使用作用域 API 令牌，而非仅限浏览器的 OAuth。

→ 开始阅读