本指南介绍如何在 Claude 上构建 “commerce agent”（商务智能体）。其中包括两类智能体：一是 “shopping agent”（购物智能体），供客户在您的应用内使用；二是 “merchant agent”（商家智能体），供店铺运营人员使用，这些人员可以是企业自己的运营团队，也可以是其平台上的卖家。本指南通过 Claude for commerce 来实现这一点。Claude for commerce 是一个开源蓝图，包含以下内容：每种智能体分别基于 Messages API、Claude Agent SDK 和 Claude Managed Agents 的可运行实现；零售、旅游、电信和娱乐行业的可运行示例；以及一个 Claude Code 插件，可针对您自己的系统搭建相同设计的脚手架。

代码、设置说明和安全文档位于 GitHub 上的 Claude for commerce 代码仓库中。如需了解这些智能体的构建方式及其设计原因，请阅读工程博文高效商务智能体剖析指南。博文涵盖以下主题：单智能体加 “skills”（技能）的设计、将 UI 组件作为工具、由 “harness”（运行框架）强制执行的安全机制、提示缓存、记忆以及 “evals”（评估）。

注意

该蓝图是供您 fork 和改造的参考实现，而非受支持的产品或托管服务。

购物智能体

购物智能体运行在您的应用内，通过单一后端接口访问您的系统。您需要基于自己的商品目录、购物车、偏好、订单、政策和履约服务来实现该接口。该接口上没有任何方法会下单或转移资金。在对话中，该智能体可以：

  • 搜索商品目录，比较候选商品，并将客户描述的需求转化为候选清单和推荐。
  • 围绕某个目标（例如一次旅行、一场活动或一个房间）规划一组相互搭配的商品，并使其符合预算。
  • 以在对话中渲染的 UI 组件形式展示商品、比较结果、方案、订单状态和购物车。
  • 填充购物车并移交给您的结账流程。
  • 依据您自己的订单和政策系统，回答有关订单、配送、退货和政策的问题。
  • 记住客户要求它记住的内容，并在之后的会话中加以应用。

五项技能按需加载，分别涵盖搜索与发现、购买调研、围绕目标的规划、客户服务，以及记忆与个性化。智能体在大多数轮次中都需要遵循的规则（例如 “grounding”（事实依据）、购物车与结账语义以及呈现方式）则放在系统提示中。

智能体只依据对话中的工具结果来陈述商品、价格、库存情况和店铺条款；写入购物车时，只接受在该会话中由商品目录工具或订单工具返回的商品 ID。结账时会暂存一份摘要，由客户在您的应用中确认。如果您使用托管结账，您的后端会返回其 URL，由宿主应用直接渲染，而不经过模型。

商家智能体

商家智能体为店铺运营人员提供支持。它通过自己的后端接口访问您的分析、商品目录、库存、定价和营销活动系统，并且可以：

  • 解释业务表现：某项指标为何变化、由哪个细分群体驱动，以及与可比时期相比的进度。一个可选的分析委托代理会在时间和数据量预算内运行只读查询。
  • 呈现每日摘要，列出需要关注的事项，包括低库存、滞销商品和订单异常。
  • 根据运营人员提供的材料改进商品详情内容并修正商品目录数据。
  • 在店铺的防护规则范围内推荐价格调整和促销活动，并提供利润率预览。
  • 起草营销活动，包括受众、投放位置和预算。

它的五项技能涵盖业绩洞察、库存与运营、商品目录与商品详情、定价与促销，以及营销活动。

商家智能体提出的每一项写入操作，无论是商品详情更新、价格调整、库存操作、促销活动还是营销活动，都是一项暂存变更，带有服务器生成的 ID，运营人员会以预览卡片的形式看到它。最大调价幅度、促销力度、补货数量、营销活动预算和受保护字段等防护规则，会在变更暂存时检查一次，并在应用时再次检查。只有在有人于对话之外批准后，变更才会生效：在 Messages API 路径上是商家门户中的一个按钮，在 Agent SDK 控制台中是一个确认提示，在 Claude Managed Agents 上则是应用工具上的始终询问权限策略。在聊天中输入的批准不会批准任何内容。

行业示例

每个示例都包含一个基于虚构数据的客户店面和一个商家门户。

行业 店面 商家门户
零售 基于内置组件的搜索、比较、方案、购物车、结账和记忆 每日摘要、暂存的补货和商品详情修正，以及基于 SQL 视图的分析委托代理
旅游 与日期绑定的库存和行程组件 入住率日历和按日期窗口的价格调整
电信 账户上下文、套餐矩阵和由服务器生成的费用披露 套餐组合、注明受影响线路的价格调整，以及受保护的监管费用
娱乐 限时保留、候补名单、转让、场馆地图和全包费用披露 活动销售进度、能真正增加可售容量的保留释放，以及保留费用的价格调整

运行环境

Messages API 和 Agent SDK 运行时可以在 Claude API、Amazon Bedrock、Claude Models on Google Cloud (Google managed) 或 Microsoft Foundry 上运行，也可以通过您自己的网关运行。Claude Managed Agents 路径在 Claude API 上运行。代码仓库中的部署指南说明了每条路径在何处选择平台，以及各自需要哪种模型 ID 格式。

使用 Claude Code 插件构建您自己的智能体

该蓝图附带一个 Claude Code 插件。该插件以克隆下来的代码仓库作为参考，针对您自己的系统构建智能体。它的四个命令覆盖了从零开始到完成测试的智能体的完整路径：

命令 作用
/scaffold-commerce-agent 询问您的技术栈，复述规划方案，并基于参考包搭建购物智能体、商家智能体或两者的脚手架
/add-commerce-flow 为现有智能体添加一个流程：复制其技能，接入其调用的工具，并编写其首批评估用例
/author-commerce-evals 构建评估套件，包括运行器、基于您自己商品目录的首批用例，以及用于 CI 的回放关卡
/review-commerce-agent 梳理您已在运行的智能体，将其与参考实现进行比较，并转换您选定的部分

该插件还包含六项技能，分别涉及架构、提示缓存、将 UI 作为工具、信任与安全、评估以及商家运营。每当 Claude Code 对话与这些技能匹配时，它们就会加载。安装说明见代码仓库的 README。

如果您想手动改造参考实现，请基于您的服务实现购物或商家后端接口，使用配置标志关闭您没有的系统，使其工具和相关提示内容不再出现，并设置您的品牌名称、助手名称和语气风格。代码仓库中的后端指南详细介绍了身份与凭据、有序流程、结账移交以及带选项的商品。试点项目可以只实现搜索和商品详情，其余部分使用桩实现。

开始使用