# Anthropic 发布电商 Agent 架构与生产实践指南，并开源 commerce-agents 参考实现 - 来源：Claude：Blog（网页） - 发布时间：2026-09-03 01:01 - AIHOT 分数：63 - AIHOT 标记：精选 - AIHOT 链接：https://aihot.virxact.com/items/cmtkcffah018zrog0zokk6s30 - 原文链接：https://claude.com/blog/the-anatomy-of-effective-commerce-agents ## 精选理由 Anthropic 从多个企业部署中提炼出电商 Agent 的架构选择、缓存与延迟手段和安全执行位置，方法可迁移到类似的消费级 Agent 工程。 ## AI 摘要 Anthropic 发布电商 Agent 构建指南，基于与零售、旅游、电信等团队的落地经验，核心架构是单个 Claude 在标准 Agent 循环中配合技能与工具，而非按领域拆分子智能体，并开源了 anthropics/commerce-agents 参考实现，含购物与商家 Agent。 ## 正文 面向更便捷在线买卖的智能体：其架构、延迟与成本技术，以及评测实践。 分类 智能体 产品 Claude 平台 日期 2026 年 9 月 2 日 阅读时间 5 分钟 https://claude.com/blog/the-anatomy-of-effective-commerce-agents 作者 Ali Shazal Matthew Koen 过去一年里，我们与电商行业的众多团队——包括零售商、市场平台、旅游、娱乐和电信运营商——合作，使用 Claude 构建电商智能体。 这些智能体已投入生产环境，企业客户在使用它们后，购物车金额更大，卖家运营效率也更高。它们还共享一个简单的架构：Claude 运行在智能体循环中，配备一组技能、工具和一套强大的评测套件。 本文面向正在构建这些（或其他面向消费者的）智能体的工程师和工程负责人。第 1 部分介绍架构，这部分只需决策一次。第 2 部分介绍延迟和成本。第 3 部分介绍生产环境：记忆、安全、评测，以及如何在组织内扩展这项工作。 参考实现 我们还提供了一份 蓝图 ，帮助你在 Claude 上构建商务智能体。其中包含工程团队在数天内让商务智能体运行起来所需的测试框架、模式和护栏，并提供了面向零售、旅游、电信和票务平台的购物智能体与商家智能体的参考实现。 anthropics/commerce-agents → 本指南内容 Part 1: The architecture 什么是商务智能体？ 技能，而非子智能体 系统提示词还是技能：按使用频率决定 工程智能体工具 UI 组件即工具 Part 2: Making it fast and affordable 最小化任务完成延迟 感知延迟 提示词缓存 选择模型及其配置 Part 3: Running it in production 跨会话存续的记忆 安全：强制机制位于 harness 层 评测：交付一个非确定性系统 在大型组织中落地发布 展望未来 架构 在标准智能体循环中使用一个模型，以技能应对长尾需求，以工具调用你已在运行的系统。你只需做一次这个决定。 什么是电商智能体？ 我们将电商智能体定义为：能够简化在线目录中买卖流程的智能体。 有些智能体面向消费者：它们负责搜索、比较、替换并组装订单。这可能是零售购物车、旅行行程、手机套餐变更，或为某场演出预留的座位。有些智能体面向商家：它们解答销售相关问题、开展促销和营销活动，并管理库存与定价。 核心架构是在标准智能体循环中运行的一个模型：围绕目标进行推理、探索上下文、通过工具采取行动、通过技能学习流程、提出澄清性问题，并观察结果，直到目标完成。 其前方没有对对话进行分段的意图路由器，其后也没有一组特定领域的智能体。 工程背景 用技能，而非子智能体 商务智能体必须覆盖跨多个品类和意图的广泛能力，这让人很容易想为每个领域创建一个子智能体。 实践证明这种做法并非最优，因为一次商务对话是跨越多个意图和轮次的紧密耦合会话，需要大量共享上下文。 在子智能体架构中，编排器持有购物车或暂存变更、用户偏好以及对话历史。 每一次向子智能体的交接都是一次有损状态的操作，这往往会影响子智能体回复的质量，进而影响整体回复质量。除此之外，每次交接还可能消耗数倍的 token，并增加数秒的延迟。 而且这些领域很少能干净地切分开。一个退货流程可能需要订单历史、当前购物车和产品目录，这意味着按领域划分子智能体的做法要么在每个地方都重复访问这些数据，要么就得在任务中途进行交接。 随着模型越来越智能，它们也能处理更长的上下文、更多的技能和更多的工具，因此当前放置规则背后的限制会随着每一代模型的更新而逐渐放宽。 相反，智能体技能能为你提供类似的按领域模块化和上下文控制，却无需承担交接的代价，因为技能指令会加载到已经掌握完整历史记录的主智能体中。 在我们对多个企业部署的对比中，一个带技能的单一智能体在质量上始终优于“一个提示词包打天下”的设计和子智能体设计，而且通常每个任务的成本和延迟也更低。 子智能体真正能发挥价值的地方，在于编排器可以将它们作为工具来调用，以处理某个狭窄或自包含的任务——这类任务受益于拥有自己专用的上下文窗口。 一个常见的生产示例是深度研究子智能体，子智能体会搜索并阅读文档、编写并运行代码、遍历数据模型，也会碰壁走入死胡同。所有工作都在一个或多个子智能体内部完成，只有一份精简的答案返回给编排器。 另一个例外是已有自己专用智能体的领域。如果你的药房或金融服务体验运行着一个带有自身合规体系的专用智能体，正确的做法可能是交接（hand-off），由该智能体接管任务，并通过自己的循环直接与用户协作，直到任务完成。 区别在于对话的所有权。交接让领域智能体成为用户的对话对象，而委派则保留编排器，在单次交互中让领域智能体进进出出，每一次交换都会造成性能损耗。 系统提示词还是技能：按使用频率决定 决定将一组指令放入系统提示词还是技能时，主要考虑因素是智能体使用它的频率。加载技能会消耗一次模型交互，因此智能体在大多数交互中都需要的内容通常应放入系统提示词。 不过，这确实取决于你的流量分布情况，以及评估所显示的智能体行为。一个不错的起点是：任何与三分之一或以上流量相关的内容——无论是在上线前预判到的，还是在生产环境中观察到的——都应放入系统提示词，其余内容则放入技能。 如果某项技能可以根据你已有的信号（例如用户到达时所在的页面）进行预测，我们建议在首次模型调用之前从 harness 中注入该技能，并跳过加载技能的额外一轮交互。 关键指令，如安全和法律规则、品牌约束，以及关键用户事实（如过敏信息），始终放在系统提示词中。 对于电商智能体而言，这意味着产品搜索放在提示词中，因为几乎每次会话都会用到它，而技能则承载长尾功能。 在我们的参考实现中，购物智能体的提示词包含 grounding、购物车和结账语义、展示规则，其余功能由以下技能覆盖：搜索发现、购买研究、规划目标、客户关怀和记忆个性化。 商家智能体采用同样的拆分方式，其技能包括绩效洞察、目录列表、库存运营、定价促销和营销活动，每个运营领域对应一个技能。 在提示词中 购物智能体 Grounding、购物车和结账语义、展示规则以及产品搜索。 购物技能 长尾功能 搜索发现 · 购买研究 · 规划目标 · 客户服务 · 记忆个性化 商家技能 每个运营领域一个技能 业绩洞察 · 商品目录列表 · 库存运营 · 定价促销 · 营销活动 工程智能体工具 我们关于为智能体编写高效工具的博文涵盖了工具设计的总体原则。在商务领域，有两点最为关键： 在核心系统和逻辑之上构建智能体工具。 一家商务公司已经拥有搜索和排序、购物车、偏好与画像存储、库存系统、促销和活动引擎、销售分析等系统，每一个都承载着多年调优的逻辑，并且能看到模型永远无法触及的信号。 智能体的工具应当调用这些系统，而不是重新实现它们，而工具边界正是这些系统逻辑的终点、模型判断接管的起点。 例如，当智能体调用 search_products 时，返回的结果应当已经完成排序；它的职责是决定哪些结果能服务于用户的目标、展示多少条，以及如何呈现。 工具结果即上下文。 只返回模型用于推理的字段，其余全部丢弃。每条搜索结果行上的图片 URL 通常是罪魁祸首。 根据需要，在工具内部对原始响应进行重塑，包括在数据本身无法明确下一步时追加一个后续步骤。 这在错误场景中尤其重要，此时模型从指令中获益比从错误代码中获益更多。例如，添加一条错误指令“查询可用性时请包含产品 ID”，而不是返回一个笼统的 403。 UI 组件即工具 大多数电商智能体的响应是 UI 组件而非文本，无论是产品轮播图、行程单、座位图还是图表。这意味着智能体必须输出一种模式（schema）而不是文本。 团队有时会先提示模型输出自定义标签，然后在客户端解析这些标签。但随着应用规模的扩大，这种做法会失效，原因如下： 模型在你的标记语言上的训练程度不如在工具调用上的训练程度，因此随着嵌套组件的增加，可靠性会下降。仅靠提示词并不能保证输出格式良好的数据。 标签定义位于系统提示词中，因此每新增一个组件都会使上下文膨胀，而每一次编辑都可能导致提示词其他部分出现回归问题。 过去的对话最终会以一种只有你的解析器才能读取的格式存储，因此加载历史记录意味着要么在客户端解析原始消息，要么以模型 API 非原生的格式保留第二份副本。 经得起考验的模式是把每个 UI 组件都做成一个工具。模型调用 present_products、present_itinerary 或 present_plan_comparison，并携带类型化参数；你的服务器验证并丰富该调用，然后发出一个事件；你的客户端负责渲染。 由于这些组件本质上是工具调用，它们已经以原生格式存在于 messages 数组中，因此重新加载旧对话时无需再次解析。下面以及参考仓库中展示了一个演示型工具契约的示例。 代价在于流式传输的粒度。工具调用的每个顶层参数都会在服务器端进行缓冲以用于验证，因此即使开启了流式传输，演示型工具的子组件也是分步到达的。这会影响感知延迟。 要获得 token 级别的流式传输，请在工具定义中设置 eager_input_streaming: true，这会跳过缓冲，同时也就跳过了服务器端的模式保证。 在我们的评估中，Claude Sonnet 级别及以上的模型出现模式违规的情况非常罕见，但仍建议为调用包裹一层重试机制，以应对偶发的漏网之鱼。 演示型工具还能让智能体记录屏幕上显示的内容。当客户说“第一家酒店”或“左边往下数第三个”时，布局信息就在 messages 数组中，位于最近一次演示调用的参数里。 要做到这一点，参数必须反映渲染后的布局，因此要按照 UI 的结构方式来组织它们，采用有序的行和轮播形式，而不是让客户端重新排列的扁平列表。 让它又快又实惠 从端到端延迟和感知延迟两条战线同时下手，让缓存来承担成本。这些都不应该消耗智能算力来实现。 延迟在电商中很重要，而面向消费者的界面是最不容忍延迟的。然而，在智能体界面上，我们反复看到能推动留存率、参与度和购物车规模等指标提升的，是结果的质量。 与边际延迟收益相比，答案是否相关、任务是否真正完成，对这些指标的影响更为关键。 所以要双管齐下地攻克延迟。通过良好的工程实践将端到端延迟降到最低，同时配合降低感知延迟（因为观看智能体工作的时间会被视为进展）。 每个用户都有一个延迟预算，下面的技术能让智能体保持在预算之内，而且不需要消耗智能算力来实现。 最小化任务完成延迟 任务完成延迟是所有模型轮次中“最后一个 token 生成时间”加上“工具处理时间”的总和。这给你提供了三个可优化的方向：更少的轮次、更快的工具、更快的 token 生成。这些方向有时会相互冲突，所以需要最小化的是总和，而不是其中任何一个单项。 更少的轮次 预先加载可能需要的上下文，提高模型智能水平，并让模型并行调用相互独立的工具。 更快的工具 优化工具自身的后端，并在工具参数完整后立即主动调度执行。 更快的 token 生成 通过运行你的评测套件来选择模型及其配置。 更少的轮次 查询的复杂性会增加轮次，而这通常不在你的控制范围内。模型智能水平和相关上下文能帮助智能体用更少的轮次完成任务。我们在这方面的一些关键经验包括： 预先加载可能需要的上下文。如果用户是从产品页面打开助手，或者商家是从营销活动仪表盘打开助手，就把该页面的数据放入会话上下文中。对话很可能围绕这些内容展开，直接从上下文中回答不会增加额外的轮次。 提升模型智能。更聪明的模型能减少完成任务所需的整体轮次，因为智能体可以更高效地规划并发出工具调用。这往往比它们较慢的 token 生成速度更重要。如果你的查询偏向复杂，或生产环境中每个任务超过约五轮交互，那么更快的模型往往就是更聪明的那个。具体哪个更优取决于你的流量特征，因此应按照下文“选择模型”部分所述，通过对比测试来抉择。 让模型并行调用相互独立的工具。商业用例通常需要大量并行操作：无论是搜索多个产品、查询多份政策文档，还是从多个销售数据源获取记录。并行工具调用可确保多个独立查询不会消耗额外的交互轮次。提示模型在单轮内调用多个工具，并以一个用户消息的形式返回一组工具结果数组（参见并行工具使用文档）。 更快的工具 优化工具自身的后端。有时工具确实会真正地扇出——一个带有“获取今日快照”查询的商家智能体会在三次独立调用中分别读取销售、库存和活动状态。但我们经常看到，工具边界成了缺失后端逻辑被拼凑起来的地方：一个库存可用性检查会调用目录服务获取 SKU、按门店调用库存服务、调用履约服务获取截止时间，然后在工具自身代码中应用替换规则和取货资格判断后才给出答复。这个工具如今承载了过多的领域知识，随着规则变化很难保持正确，并且携带了本应放在上游系统中的逻辑。当你发现自己在工具中编写这类逻辑时，解决方案是创建一个能回答该问题的后端端点，并用智能体工具来调用它。 急切地派发工具调用。工具参数会像其他 token 一样从模型中流式输出，因此当每个工具的参数完整流出时，执行框架就可以立即发起该工具的调用，并在模型仍在流式输出其他并行工具或内容块的同时处理其结果。我们发现这能把原本数秒的间隔缩短到几百毫秒，而 Claude Agent SDK 默认就是这么做的。你应该提示模型先输出最耗时的调用，以获得最大的延迟收益。 感知延迟 感知延迟是指用户感受到的、从发出请求到屏幕出现反馈之间的时间。在面向消费者的场景中，这一点尤为关键，因为任何交互摩擦都会影响结账转化率和收入。有两种技术可以在不改动模型的情况下缩短感知延迟： 组件边生成边流式传输。一个典型的电商回复通常包含 500–700 个输出 token，如果不采用流式传输，用户就要面对五秒甚至更久的加载动画。将展示工具的每个参数在流式生成的同时发送给客户端，并逐步渲染页面。 展示工作过程。当智能体在收集上下文时，用通俗的语言为每个步骤渲染一行简短的进度提示（例如“正在查找水边的酒店”）。你可以根据工具已有的参数来构建这些提示（例如商品搜索的查询词），也可以额外添加一个 `user_facing_message` 参数工具，提示模型来撰写这行文字。 上面两个面板运行的是同一个智能体，使用相同的工具和提示词；只有执行框架不同。总耗时大致相同，但用户看到内容的时间却大不相同。 提示词缓存 提示词缓存是你最大的成本削减机会，而电商流量非常适合利用它。缓存输入 token 的读取成本仅为全新 token 的十分之一，虽然缓存写入有约 1.25 倍的溢价，但缓存前缀在第二次使用时即可收回成本。在面向客户、流量庞大的应用中，你有一个独特的机会，可以利用最便宜的默认 5 分钟缓存过期时间，达到非常高的缓存命中率。 我们见过的表现最好的电商部署，缓存命中率能达到 90–99%，而这正是从一开始就应该以此为目标进行设计的区间。我们的经验表明，在约 100k token 规模下，缓存 token 的读取速度也快约 1.5 到 2 倍，而且随着 token 数量增加，这一速度优势基本呈线性扩展。 缓存是基于前缀的。一个请求会从缓存中读取，直到遇到与先前请求不同的第一个字节为止，因此重要的不仅是上下文里有什么，还包括它们的排列顺序。可以把一个请求看作三个片段，按它们变化的频率排序： 全局部分：系统提示词和工具定义的大部分内容，在每个会话中完全相同。这是你最“热”的缓存，在规模效应下，很可能不会过期。请确保它在各轮对话和各个会话之间保持逐字节一致，并在其末尾设置一个缓存断点。 会话部分：每个用户各自的上下文和对话历史，在不同会话之间有所不同，但在同一个会话内保持稳定。这部分位于全局部分之后。 易变内容：会话中会变化的任何内容，例如当前时间或当前页面。请将其放在请求的最末尾，既可以作为最新用户轮次中带标签的块，也可以在支持对话中途系统消息的模型上，作为追加到消息数组中的系统角色消息。我们见到最常见的错误是把时间戳或当前页面放在系统提示词的开头，这会在每次请求时悄悄破坏缓存。 这里有两个实现细节需要记住。首先，技能应作为工具结果加载，而不是附加到系统提示词中。这样技能正文就会进入对话前缀，并随之前缀一起被缓存。 其次，在每一轮中向前滚动你的断点：一次请求允许的断点数量有限，因此请将最新的断点移到每个用户轮次的末尾。这样每一轮都能从缓存中读取累积的历史记录，包括搜索结果等较长的工具结果。 选择模型及其配置 模型大小和推理投入设置是同一类权衡——用智能换取延迟和成本——你应该通过测量来同时选择两者： 选定你的指标和底线。选择你的业务所依赖的质量指标（任务完成率、答案相关性、有据准确性）、你不愿低于的评测分数，以及你的 p50 和 p99 延迟与成本预算。 全面扫描。在你考虑采用的每一个模型和每一种推理强度上，运行你完整的评测套件。我们建议，对于商家智能体，从 Opus 开始，因为其任务以分析为主；对于消费者智能体，从 Sonnet 开始，因为延迟权重更高。如果你有生产流量，请根据你真实的查询组合对结果进行加权。然后让数据说话。有时，Opus 5 在购物车驱动任务上的提升足以证明其相比 Sonnet 的成本差异是合理的，有时则不然。 仔细阅读结果。有两件事经常让团队感到意外。第一，提示词是为特定模型调优的，因此用同一个提示词进行扫描，可能会让那些并非为其编写的模型表现不佳。较小的模型通常需要当前模型能自行推断出的指令，而较大的模型则会不折不扣地遵循较小的模型所忽略的指令。在排除任何候选模型之前，针对每个候选模型的失败案例进行几轮迭代，是一个成本低廉的步骤。第二，更智能的配置有时会在延迟上胜出（最常见的是 p90 和 p99），尽管其 token 生成速度较慢，因为它能更好地规划工具调用，在最复杂的请求上需要的轮次更少。 衡量每个完成任务的成本，而不是每次模型调用的成本，因为一个更便宜的模型如果需要更多轮次，或失败更频繁，实际上并不便宜。当结果接近，且成本符合你的单任务经济性和延迟要求时，选择智能。质量是驱动采用和留存的因素，并且能在未来 6 个月随着模型变得更好，为你留出构建空间。 在生产环境中运行 记忆、安全、评测，以及在组织内扩展工作规模：什么能让智能体通过生产环境的考验并持续运行下去。 最后，我们讨论了是什么让智能体真正落地生产：记忆、安全、评测，以及如何在整个组织中扩展这项工作。 跨越会话周期的记忆 你与客户之间的关系和互动至关重要。记忆让智能体能够从上次对话结束的地方继续，而不是从零开始。一位在三月份提到过坚果过敏的购物者，不应该在六月份还要重复一遍；一位每周一都会查看同样三个广告活动的商家，也不应该每次都重新说出它们的名字。长期记忆——即那些应当跨会话周期保留的事实——是你构建的一个系统，它包含三个部分：事实如何存储、如何写入，以及如何读取。 存储记忆 记忆属于你的系统，而不是模型本身。 当档案规模较小且智能体是唯一读取者时，一个扁平的 markdown 档案文件是可行的。但大多数生产级电商智能体会很快超出这种模式的承载能力，而实际的替代方案就是你已经在运营的数据库。一条事实就是一条小型的有类型记录：一个键（例如 shoe_size、default_store、preferred_report_cadence）、一个简短的值、一个类别，以及它来源的会话。有些键是你预先决定好的，每个用户都会拥有；其余的则由提取器自行发现。随着存储规模的增长，数据库始终保持可查询性，让你能够在特定属性上构建确定性的行为，并能与你已有的用户数据关联起来。 对于面向商家的智能体，记忆应按“人”而非“账号”来区分。商家登录账号通常由多名操作员共用，因此每位操作员都需要有自己的独立档案，且读取时必须遵循该操作员的权限：门店经理的智能体不应回忆起区域经理曾陈述过的事实。 在电商领域，智能体记忆承载着个人数据。值得记住的事实往往正是受监管最严格的数据，而不同司法管辖区之间的规则也各不相同。应将记忆视为一个数据处理设计问题，而不仅仅是存储问题。具体而言，这意味着四件事： 明确你愿意保存哪些类型的记忆。在写入路径上强制执行这一限制，通过一个所有保存操作都必须经过的校验器来实现，而不是仅靠提示词来约束。 为用户提供查看、更正和删除已存储数据的方式。将删除功能接入你的账号注销和数据请求流程中。 设定保留期限。几年前的偏好很可能已经过时，因此保留期限有助于保持记忆事实的新鲜度。 记忆应作为按部署实例可配置的开关。这样，无法承担这些义务的地区可以在不启用记忆功能的情况下运行。 写入记忆 以异步方式写入记忆。在每一轮对话结束时，或在长会话中每隔几轮，由独立线程或进程中的智能体读取对话内容，并在存储中创建、更新或删除事实，同时随着会话推进维护自身的工作上下文。 它不会给对话增加任何延迟，并且在我们内部的电商记忆评测套件上，事实召回率提升了 13%。 显而易见的替代方案——让智能体调用工具来保存一条事实——对于延迟敏感的电商智能体而言是错误的做法。每一次保存都是面向用户回合内部的一次工具调用，而且除非整个商店都在上下文里，否则一次保存需要先做一次读取才能更新或去重，这本身就是一轮往返。 它还会在每个回合给智能体增加一个额外的决策点，而在我们的评测中，这种注意力竞争表现为记忆遗漏。 将提取器分离出来，还能让你对它进行精准的提示词设定。它只读取用户和助手的文本，从不读取工具结果，因此产品描述或评论不会变成关于用户的事实。它的提示词会明确什么算作事实——比如用户声明的尺码、饮食限制、履约偏好、商家常用的物化视图——什么不算，比如来自商品列表的任何内容或一次性细节。 读取记忆 记忆分三层读取。 始终在上下文中 一小部分固定的事实会在每个回合都进入上下文：那些几乎每个请求都依赖的事实，比如购物者的默认商店和履约偏好，或者运营者的商店和角色。 每回合预取 与当前请求相关的事实会按轮次预先获取，所依据的信号与预加载技能时相同：一次鞋子搜索会拉取尺码和品牌偏好，一次营销活动问题会拉取运营人员常用的指标。 置于查询工具之后 其余所有内容都置于一个查询工具之后。 由于记忆属于每个用户各自的上下文，因此所有这些内容都放入会话段中，位于全局缓存断点之下。 安全：执行机制位于框架层 提示词是安全行为的起点，但在商业场景中，安全不能仅靠提示词来执行。这类失败往往涉及资金损失且常常无法挽回，而一条提示词规则可能因一次注入或一个不良样本就被跳过。以下每一条规则都在代码层面强制执行，同时作用于消费者端和商家端智能体，并且只定义一次，让所有运行时共享同一套规则。 模型负责提出方案；由人或策略来执行 没有任何模型工具调用能够直接转移资金或改变业务状态。订单提交、支付、退款、价格变更和营销活动上线，最终都落在由框架层控制而非模型控制的动作上。 在消费者端，这一点是结构性的：结账工具渲染购物车并附带一个提交订单的按钮，而智能体所调用的后端接口根本不存在任何扣款方法。 在商家侧，每个写入工具都会生成一个带有服务器生成 ID 的分阶段变更，而 apply_change 仅对已通过真实界面获批的 ID 才会成功：该界面可以是运营人员门户中的按钮、CLI 中的确认，也可以是智能体在 Managed Agents 上运行时平台自身的工具审批提示。 护栏会在 apply 时根据当前限制重新检查，而非依据变更暂存时生效的限制。无论界面为何，其形态都是一致的：模型最危险的动作是提出建议，而审批则经由你的企业针对该类变更已在使用的 maker-checker 流程完成。 写入与渲染仅接受服务器签发的 ID 该测试框架会按会话记录服务器向模型下发的每一个 ID，而这份记录是任何写入或渲染操作唯一会接受的密钥。 购物车仅接受服务器在本会话中返回的产品 ID，商家工具仅接受智能体实际读取过的 listing 和 campaign ID。以任何其他方式出现的 ID——无论是模型幻觉产生的、用户粘贴的，还是植入在评论中的——都会在后端看到之前就被拒绝。 同样的规则也适用于 UI。展示工具接收 ID，而服务器自行填充产品、订单或变更记录，因此卡片只会渲染服务器自身填充的记录。 该规则同样覆盖委派智能体：商家分析子智能体可以读取数据，但绝不会增加智能体可写入的 ID 集合。 对于费用、披露及其他受监管内容，模型只负责选择披露哪款产品，而服务器端则从已批准的文案中逐字提供全部内容。同样的费用字段也位于商家智能体的受保护清单中，因此交易双方都无法更改或改写这些内容，评测会对渲染出的字符串进行逐字节比对。 设有上限的交易必须能应对重复请求 大多数电商界面都会限制单个用户可购买某件商品的数量——无论是出于票务配额、促销定价还是防欺诈考虑——而智能体会以人类点击按钮时从未有过的方式去重试、改写措辞和并行操作。 因此，该上限是在写入后按行强制执行的，这样第二次“再加两件”就无法叠加超出上限；同时，同一会话内的购物车写入会被串行化，确保单轮中的并行工具调用无法合并后突破上限。 商家变更同样按照价格波动上限、折扣深度、补货规模和活动预算的限额进行检查，此外还有一份任何变更都不得触碰的受保护字段清单。这条规则可以推广：对最终状态而非请求本身执行每一项限制，并按会话串行化写入操作。 第三方内容经过净化处理 在电商场景中，大部分上下文内容是由非你方人员撰写的——卖家、评论者、竞争对手——因此每一次后端读取都属于不可信输入，都要经过同一个净化器处理。 由第三方生成的每一条工具结果，例如商品列表、评论、政策、卖家消息和存储的记忆，在模型看到之前都会被净化处理，并包裹在带有固定标签的围栏中。 净化器会剥离控制字符和双向字符，移除任何模仿围栏标记的内容，化解模仿对话轮次或工具调用的文本，并限制大小，旨在防止恶意列表冒充系统或填满上下文。 提示词承担了契约的另一半：围栏内的文本是供报告参考的材料，绝不作为行动依据。 评测：交付一个非确定性系统 从微小的提示词改动到引入新工具，任何变化都可能以难以预测的方式改变智能体行为，而你所交付的改动往往不是导致性能回退的那一个。评测正是你在部署之前发现这些问题的手段。我们之前关于智能体评测的博客文章涵盖了通用实践。本节则聚焦于电商智能体的具体细节。 评估快照，而非对话 模型的 API 是无状态的，因此智能体的输出是系统提示词、工具和消息数组的函数。这意味着电商对话可能达到的任何状态都可以被直接构造出来。因此，创建评测用例意味着构造测试状态、附加测试用户消息，然后让智能体从该状态开始运行。 然后对结果进行评分：最终状态和渲染后的响应，包括最后一次写入的参数。在大多数情况下，我们建议不要对智能体达成结果的路径进行评分，因为这类测试用例很脆弱且限制过多。 模拟用户评估（由第二个模型扮演用户，并由评判模型对整个对话进行评分）并不是一种好的衡量工具。两个非确定性系统交互需要更大的样本量，每次试验成本更高，更难评判，而且产生的失败难以归因。它们对于发现覆盖缺口和对智能体进行整体观感检查很有用，因此可以用它们来发现案例，然后将每个案例写成快照。 在严苛条件下评估行为 大多数团队未能正确测试注入的状态。一个案例应该编码失败的前提条件，而不仅仅是任务。如果某种行为只在繁忙的第一轮多次工具调用之后出现，或在会话早期出现矛盾之后才出现，那么从干净状态开始的案例会在每种配置下都通过，无法提供有意义的数据。 我们观察到大多数测试套件都偏重于这类“干净状态”的用例，所以请确保你的测试中有一部分是从冗长、混乱或相互矛盾的历史记录开始的。 覆盖不同类型的商务智能体评测 有效的评测需要同时测试期望行为与非期望行为。 对于每一个正面用例，都要写出对应的反面用例：每一个“应当拒绝”都要配一个“应当提供”，每一个“应当先询问”都要配一个“应当直接执行”。缺少反面用例是我们在一套测试集中发现的最常见缺口。 针对以下方面进行评估： 构成你流量主体的核心请求，因为这里的失败会影响大多数会话。这些请求包括简单查询、多约束请求、产品和套餐问题，以及多意图消息。对于这些问题，要检查每一个价格、可用性和属性是否都能追溯到返回的数据，并且智能体在数据缺失时能如实说明，而不是凭空编造。 依赖上下文的请求，例如引用屏幕上的内容、从先前轮次延续下来的约束条件，以及针对现有购物车进行的写入操作。对记忆能力的评估也归入此类。需要检查记忆是否被提取、检索，并最终改变了回答结果。 安全与品牌相关场景，此类场景一旦出错就会造成金钱或信任方面的损失。这些场景包括试图进行的提示注入、试图读取其他用户数据的行为，以及需要逐字节核验的受监管语言。将注入分为两类：一类是用户撰写的注入，即指令来自用户自身的消息；另一类是数据平面注入，即指令被植入产品名称、评论或通过网络工具结果获取的网页片段中。 界面评估，用于确保渲染出正确的组件、条目数量上限得到遵守，并且面向用户的文本中不包含任何内部标识符。同时也要测试超时和空结果的情况。 同时涉及多种能力的请求。运营人员问：“如果我把这个降价 15%，我的库存够不够覆盖需求？”这既是定价问题，也是库存问题。正确的答案会在降价方案中附带库存预测；错误的答案则只处理了其中一半而忽略了另一半。按单一能力编写的评测无法发现这类问题，因为每个评测只考核自己负责的那一半。要为需要相邻两种能力协同处理的请求编写测试用例，并对答案的两半部分都进行评分。 与领域专家共同编写评测，并使用真实事件 与能直接看到失败案例的领域专家合作设计测试用例，例如产品、法务、商家运营、客户关怀和品类管理团队的成员。真实的失败案例是最佳的评测素材，每个用户流程准备 50-100 个评测用例是一个不错的起点。 务必确保用例的多样性，如上文所述。生产环境的对话记录是获取新用例的绝佳来源，尤其是那些棘手的案例。编码智能体擅长生成额外的用例和对抗性变体。参考代码库中包含一个 Claude Code 插件，其中内置了基于我们推荐方法构建的评测编写技能。 在大型组织中交付上线 在商业企业中，智能体由多个工程团队共同构建。搜索、结账、定价、营销技术、客户关怀和商品目录平台各自拥有智能体所依赖的系统，各自按自己的节奏发布，并且各自都会希望添加或修改某个工具、技能或提示词规则。 与传统的服务不同，智能体没有严格的模块边界来保护其他部分：定价团队所做的修改，会与结账功能共享同一个上下文窗口。 一个诱人的解决方案是把系统拆分成许多子智能体，每个业务单元一个。正如第一部分所讨论的，出于质量方面的考虑，我们不建议这样做。相反，我们概述了降低多团队协作风险的过程： 所有权跟随系统而定。每个技能和工具都有唯一的所有者团队。例如，定价团队拥有促销工具和定价技能，客服团队拥有订单与退货工具以及客户服务技能。共享提示词中，通用部分由单一的平台级所有者负责，领域特定部分则由领域所有者负责。 一项变更随其测试用例一起发布，CI 会运行为其选定的一组测试。贡献技能的团队也需要贡献其测试用例，包括针对相邻技能的负面用例和边界用例。在每次拉取请求时都运行完整测试套件过于缓慢且成本过高，难以持续，因此应从中构建一个 CI 测试集。该测试集将包含一组覆盖最高流量请求的核心用例，以及所有安全用例。在此基础上，再运行与本次变更相关的用例。对于技能而言，这意味着运行其自身的用例以及相邻技能的边界用例。对于工具而言，则是运行所有调用该工具的用例。对于共享提示词而言，由于所有内容都会读取系统提示词，因此需要运行完整的评测套件。我们建议在几次试验中设置通过率门槛，并关注缓存命中率和每次交互的成本。同时，在每晚以及每次发布前运行完整套件也是一个良好的实践。跨团队的回归问题会在这些运行中被发现。 智能体也应该纳入发布日历。它是一个部署单元，因此一次糟糕的变更会同时影响到每一位用户。先将提示词和技能变更推送到金丝雀（canary）试点群体，保留一个无需部署即可关闭某项技能的开关，并在高峰期前像冻结其他系统一样冻结智能体。 关于这一安排中人的一面，请参阅《构建高效的人机智能体团队》。 展望未来 本文所描述的大部分内容与模型本身无关。工具调用的是你已在运行的系统，技能编码的是你已在遵循的流程，评测是将你的产品需求文档写成测试，而管控框架（harness）执行的是你会为任何客户执行的策略。模型会持续进步，当更好的模型发布时，我们描述的架构会将其作为一次配置变更并配合一轮评测扫描来采纳。其他一切照常运行。 同样重要的是思考你的产品形态路线图。这套架构的生命周期将超越聊天面板。同一个智能体可以应用于语音场景，也可以在用户询问之前主动针对票价下降采取行动。对于已经拥有评测和工具的团队来说，这些只是展示层项目。更长远来看，你店面的一部分流量将来自代表用户购物的智能体。那些让你的自有智能体保持合规的溯源、分级和审批规则，也正是让你能够安全地向这些智能体开放工具的关键。 商业领域向来奖励那些让购买流程尽可能顺畅的做法。智能体让这件事变得容易得多。请查看完整的参考实现，其中包含消费者端和商家端智能体，以及适用于零售、旅游、电信和娱乐领域的可运行示例。 致谢 作者：Matthew Koen 和 Ali Shazal。特别感谢 Michael Segner、Rodrigo Olivares、Amandeep Khurana、Aiza Usman、John Lopus 及其他人的贡献。 视频 · 前往原文观看 用 Claude 改变你所在组织的运作方式