Claude Commerce Agents – Anthropic 开源的电商智能体参考实现

Claude Commerce Agents 是一款由 Anthropic 于 2026 年 9 月开源的电商智能体参考实现，主要用于搭建面向顾客的购物助手与面向员工的商家助手，支持购物端与商家端各定义一次即可复用、同一套技能与工具契约跑在三条运行时上，适用于电商企业自建导购助手、后台运营助手与智能体落地方案评估等场景。

Claude Commerce Agents 的核心能力

它给出的不是成品应用，而是一份可拆开看的蓝图：两个角色、五个技能流、一套工具契约，以及把交易写操作挡在人工确认之前的护栏。适合拿来对着改，而不是拿来直接用。这套结构对 AI Agent 的落地边界划得很清楚。

购物端与商家端各定义一次，技能按流拆开

购物端负责搜索、比较、做方案、填购物车、回答订单与政策问题并记住顾客偏好；商家端负责解释经营表现、维护商品信息、处理库存与订单告警、定价促销、起草活动。两个角色各五个流，分放在 shopping-agent/skills/ 与 merchant-agent/skills/ 目录，改一个流不影响其余四个。

同一套定义跑在三条运行时上

提示词、技能、工具契约与闸门都写在 core 层，三条运行时只是外面换了一层壳：runtime-messages-api 自己跑轮次循环，runtime-agent-sdk 把循环交给 SDK，managed-agents 则以清单加 MCP 服务端的形式托管。换运行时不需要重写技能，这也是它作为参考实现最实用的地方。

商家端写操作走暂存变更与人工审批

调价、改商品信息、发活动这类动作不会直接写进系统，而是生成一条待审变更，由宿主的审批界面点过才应用。商家端控制台就是用来做这件事的，命令行版按 y 或 N 逐条决定。这条路径给审计留了痕迹。

围栏、溯源与记忆校验都埋在工具调用里

围栏、来源校验、额度上限与记忆校验跑在工具调用内部，三条运行时上行为一致；跨会话的记忆提取属于运行时能力，只在 Messages API 那条路径上显式触发，这块可对照 Hy-Memory 2.0 一类专门的记忆框架看差异。规则、模块与文件路径逐条写在 docs/safety.md 里，也写明示例没有鉴权、MCP 服务端只绑回环地址。

四个行业示例把交易形态差异摆出来

零售场景覆盖搜索、比较、方案、购物车与结账；旅游场景有日期约束库存与行程呈现扩展；电信场景带账户上下文、套餐矩阵与服务端写入的资费披露；票务场景有限时占位、候补、转赠与场馆地图，并做全含费用披露。四个示例共用一个前端工作区，差异能直接对比着看。

Claude Commerce Agents 与 LangGraph 的对比

拿它和 LangGraph 放在一起比——后者是「从零搭一套电商智能体」最常用的起点，差别主要在交付形态与护栏的位置。

差别集中在交付形态、写操作护栏与工具契约三处：左边一列对应仓库里可查的目录与文档，右边一列取自其仓库首页与官方文档，都不是推测。商家端的写动作被拆成生成变更、暂存、人工确认三步，LangGraph 给的是中断与检查的原语，审批链要自己接；工具契约先定好，接自有系统时只须实现两个后端抽象类，不必从数据结构开始谈。

如果需求偏向让智能体直接接管客服邮件与客户沟通，可以参考 Agently Mail（腾讯推出的 AI 邮件自动化与客户沟通平台，走的是收件箱里直接处理的路子）。

Claude Commerce Agents 的应用场景与适用人群

它更适合被当成蓝本而不是开箱即用的产品，落到具体环节上常见场景包括：

• 导购助手立项：先跑零售示例看对话流与工具调用长什么样，再决定保留哪几个技能流。
• 后台运营助手：把补货、改价、活动草稿做成待审变更，员工逐条确认，避免模型直接写系统。
• 方案评估与 POC：三条运行时共用技能，能较快比出直连与托管的成本差异。
• 有披露要求的行业：电信资费与票务全含费用的写法已内置，可作合规模板起点。

适用人群：做大中型电商与零售系统集成的技术团队、需要在合规前提下试水智能体的平台方，以及要评估智能体落地成本的产品负责人。

Claude Commerce Agents 的使用方法

官方给出 3 条路径：跑现成示例最快，用 Claude Code 插件搭自己的最省事，接自有系统则需要实现两个后端抽象类。

跑官方示例：装依赖填 Key 起零售场景

1. 从 Claude Commerce Agents 官方仓库 克隆代码，建虚拟环境 python3 -m venv .venv，激活后装 pip install -r requirements.txt。
2. 复制 .env.example 为 .env，填入 ANTHROPIC_API_KEY。
3. 进 examples 跑 npm ci，八个前端应用共用同一工作区。
4. 执行 python scripts/run_demo.py retail，API 起在 8000、店面在 3000；--merchant 换商家端，--all 两个都起。

用插件搭自己的：三条命令生成项目骨架

1. 先 claude plugin marketplace add anthropics/commerce-agents 加来源，再 claude plugin install commerce-builder@claude-commerce-agents 装插件。
2. 在 Claude Code 里执行 /scaffold-commerce-agent 说明用途，命令会问技术栈、复述方案再建项目。
3. 补齐业务流用 /add-commerce-flow，生成评测集用 /author-commerce-evals。
4. 已有智能体要改，走 /review-commerce-agent。

接自有系统：实现两个后端抽象类

1. 购物端实现 StorefrontBackend，把目录、购物车、订单与政策四类能力映射到自家接口。
2. 商家端实现 MerchantBackend，对接分析、目录、库存、定价与活动系统；写操作按暂存变更返回。
3. 按 docs/backends.md 核对字段映射，再跑 python scripts/smoke_chat.py --vertical retail 验证连通。
4. 部署前补鉴权：示例默认无认证，MCP 服务端只绑回环地址，对外暴露需自加网关。

本地验证可跑 ruff check . 与 python scripts/check.py，完整版 verify_all.py 还会做部署试运行与前端构建。示例里的公司与商品全部虚构，结账只渲染购物车、不扣款。

Claude Commerce Agents 的项目地址

• 项目主页：https://claude.com/solutions/commerce
• GitHub 主仓库：https://github.com/anthropics/commerce-agents

Claude Commerce Agents 的价格方案

仓库按 Apache-2.0 分发，代码可以自由使用、修改与再分发，本地跑示例不产生许可费用。它本身不是收费产品，也没有付费版与免费版的功能差。

运行成本来自模型调用：跑示例与接入自有系统都需自备 Anthropic API Key，按官方 Messages API 的计费方式结算；选择 Managed Agents 托管时，运行环境与扩缩容由平台方提供。具体单价随官方价目调整。

Claude Commerce Agents 的常见问题