为AI Agent设计产品：Resend的AEO与Agent体验实践

当AI Agent开始替人类写代码、调用API、完成端到端任务时，产品设计需要考虑的对象正在从“人”扩展到“Agent”。Resend的Zeno Rocha在一次分享中，把这个问题拆解为两个相邻但不同的领域：answer engine optimization（AEO）与agent experience。前者关心如何让答案引擎“选中”你，后者关心Agent真正动手时是否顺手。

AEO的边界：让答案引擎找到你

AEO通常被理解为面向答案引擎的内容优化——当用户把问题交给AI助手而非传统搜索框时，你的文档、API说明和产品信息能否被准确检索并作为答案呈现。这部分的落点仍是“内容可被发现、可被理解”。

Resend的做法是把文档本身当作产品界面来打磨：帮助Claude Code这类编程Agent在需要发邮件时，能快速从文档中识别出正确的邮件API，而不是在多个相似接口之间反复试错。换句话说，AEO做到位，Agent才可能“第一步就走对”。

AEO与SEO的区别

AEO（answer engine optimization）常被拿来与传统的SEO（search engine optimization）对比，但两者的优化目标并不相同。SEO面向的是搜索引擎的结果列表页，核心是让网页在关键词查询中排名靠前，用户随后点击链接进入网站自行阅读。AEO面向的则是直接生成答案的AI助手，核心是让内容被模型检索、理解并直接引用为答案本身，用户可能根本不会访问原始页面。

这种差异带来了优化重心的转移：SEO关注标题、外链、关键词密度等排名信号；AEO更看重内容的语义清晰度、结构化和可解析性——定义是否明确、步骤是否可执行、术语是否一致。对提供API的产品而言，这意味着文档的写法、示例的组织方式，都会直接影响它能否被答案引擎准确选中并转述。

Agent体验：从被检索到被调用

Zeno Rocha指出的关键区分在于：AEO结束的地方，正是agent experience开始的地方。答案引擎只需要“读”，Agent却需要“做”——它要理解参数、完成鉴权、发起调用、处理返回结果与错误。文档写得清楚只是入场券，工具本身是否对Agent友好才是决定成败的部分。

这意味着产品团队要重新审视那些过去只为人设计的环节：错误信息是否足够结构化、示例代码是否可直接执行、API的默认行为是否符合Agent的预期。这些细节在人类开发者手里可以靠经验和搜索补足，但Agent往往只能依赖眼前的信息。

什么是编程Agent

文中反复提到的Claude Code，属于“编程Agent”这一类工具：它不只是补全代码，而是能在获得授权后自主读取文件、执行命令、调用外部API，并根据返回结果决定下一步动作。与传统的代码助手相比，编程Agent的特点是具备工具调用能力和多轮自主决策——它会为完成一个任务自行规划步骤，失败后尝试替代方案。

这决定了它对产品接口的要求更高：参数命名是否自解释、鉴权流程是否简单、错误码是否携带修复线索，都会影响Agent能否在有限轮次内收敛到正确做法。人类开发者卡住时可以搜索、可以凭经验猜测，Agent则高度依赖工具本身暴露的信息质量。

文档即接口：为编程Agent降低摩擦

在Resend的实践里，文档不只是给人看的说明书，而是Agent调用链的一部分。当Claude Code这类工具需要完成“发送一封邮件”的任务时，它会在文档中寻找最直接的路径。文档结构清晰、示例贴近真实调用、命名一致，都会显著降低Agent的试错成本。

这也解释了为什么AEO与agent experience并非割裂：前者决定Agent能否找到你，后者决定Agent找到你之后能否顺利完成任务。两者之间的衔接质量，直接影响产品在Agent工作流中的采用率。

Agent友好的工具设计原则

所谓“对Agent友好”，在实践中可以落到几条具体原则上。其一是可预测性：接口命名、参数顺序、默认值应保持一致，让Agent能从少量示例中泛化出正确用法，而不是每个接口都要单独摸索。其二是错误信息可操作：返回结构化的错误码和明确的修复提示，比一句笼统的“请求失败”更有价值，因为Agent无法像人一样凭直觉排查。其三是示例可直接执行：文档中的代码片段最好是完整、可运行的，而不是省略了鉴权和导入的片段，否则Agent需要额外推理来补全缺失部分，增加出错概率。

这些原则与面向人类的可用性设计有交集但并不重合：人类容忍一定的模糊性，Agent则把每一处模糊都转化为额外的调用轮次和失败风险。

对产品团队的启示

Zeno Rocha的分享提示了一个正在成型的设计维度：产品需要同时服务人类用户与AI Agent两类“访客”。对前者，界面要直观；对后者，接口、文档与错误反馈要可被机器稳定解析。把这两层体验分开对待，比笼统地谈“AI友好”更有操作性。

对于提供API或开发工具的产品而言，AEO与agent experience可以成为一组新的评估指标：答案引擎能否准确引用你，Agent能否在最少轮次内完成任务。这两个问题回答好了，产品在Agent驱动的使用场景中才具备真正的竞争力。