Claude Commerce Agents：Anthropic 官方的电商购物/商家双智能体开源参考实现-无双技术网

一句话：Anthropic 官方开源的「购物智能体 + 商家智能体」参考蓝图，一套 Prompt/技能/工具契约同时跑在 Messages API、Agent SDK 和 Managed Agents 三种运行时上。

为什么值得关注

电商正在成为 AI Agent（智能体） 落地最拥挤的赛道。大厂各自封闭造轮子，开发者想参考一套「官方级、带完整安全护栏、能直接改造成自己业务」的范例却很难找。Anthropic 在 2026-09-01 放出的 commerce-agents 正是补这个空位——它是 Claude 官方维护的参考实现，Apache-2.0 协议，仓库一上线热度就冲上了 GitHub Trending，目前已 1600+ Star。

它并不是又一个 demo，而是一套可复用的工程样板：两类智能体、四套可运行的垂直行业示例（零售、旅行、电信、文娱），以及统一的双智能体安全模型。想搭电商助手、商家后台自动化的人，可以直接站在这套「官方地基」上改。

两个智能体，一条生产链路

项目把电商拆成两个角色，分别对应前台和后台：

购物智能体（Shopping Agent）——嵌入在商家 App 里服务顾客。能搜索、比价、做推荐、加购、回答订单与售后政策问题，并记住顾客偏好。它的五个核心流程被拆成 shopping-agent/skills/ 下的独立技能（Skill）。
商家智能体（Merchant Agent）——服务商家内部运营人员。解释业绩数据、维护商品信息、响应库存与订单预警、定价与促销、起草营销活动。关键点：它对后台的一切写入都被「暂存(staged)」，必须经过人工批准才落地，避免 AI 乱改线上数据。

两者共享一套 commerce-common 公共层：配置、沙箱护栏（fencing）、记忆、技能、接地（grounding）、展示、以及执行器框架。

设计上最值得抄的三点

1. 一次定义，三种运行。同一份 Prompt + 技能 + 工具契约，不加修改就能跑在三条路径上：Messages API（自建回合循环）、Claude Agent SDK（SDK 托管循环）、以及 Managed Agents（托管智能体，通过你的 MCP Server 调后端系统）。这意味着从「本地原型」到「云端托管」几乎零重写。

2. 安全护栏放在工具调用内部。围栏（fencing）、来源门禁（provenance gates）、额度上限（caps）、记忆校验，以及商家的人工批准闸门，都内嵌在每次工具调用中，三条运行路径全部生效。仓库明确：示例无鉴权、MCP Server 只绑 loopback——生产鉴权与合规由部署方负责，文档 docs/safety.md 一条条列出了规则与对应的模块。

3. 通过「后端接口」接你的系统，而不是硬编码 MCP 连接器。两类智能体都通过定义好的 StorefrontBackend / MerchantBackend 接口访问你的商品、购物车、订单、库存与营销系统，服务端持有凭证，模型只读到结果。官方未内置任何 MCP connectors；已有官方连接器的数据源（Snowflake/BigQuery/Databricks 等分析仓，Stripe/Square/PayPal 等支付，Slack/GDrive/Gmail 等协作）才是集成目标。

快速跑起来

Python 3.11+、Node 22。克隆后装依赖、配好 ANTHROPIC_API_KEY，一条命令拉起零售垂直示例（API 在 :8000，商城页在 :3000）：

git clone https://github.com/anthropics/commerce-agents.git && cd commerce-agents
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt       # 7 个包及其锁定依赖
cp .env.example .env                  # 填入 ANTHROPIC_API_KEY
(cd examples && npm ci)               # 8 个 Web 前端共用一个 workspace
python scripts/run_demo.py retail     # API :8000 + 商城 :3000

想跑商家后台侧就加 --merchant（portal 端口 :3100），两个都跑用 --all。四个垂直示例端口分配：retail(:3000/:3100)、travel(:3001/:3101)、telecom(:3002/:3102)、entertainment(:3003/:3103)。

快速搭「自己的」：Claude Code 插件

仓库还带一个 Claude Code 插件，用来基于你的系统脚手架出一个新智能体，或审查你已有的一个：

claude plugin marketplace add anthropics/commerce-agents
claude plugin install commerce-builder@claude-commerce-agents
claude
/scaffold-commerce-agent a shopping assistant for our store

命令会先问你技术栈、回放方案，然后构建工程；/add-commerce-flow、/author-commerce-evals 继续扩展，/review-commerce-agent 则从你已有的智能体出发做审查。

想集成进自己的业务，从这几步开始

先小步试点：购物侧只实现搜索与商品详情，其余方法 stub 掉（返回不可用即可，不用改任何 Prompt）。商家侧先实现 8 个读方法、让所有写操作拒绝，日报与指标就能在无写入路径下先跑起来。
用开关关掉你没有的东西：没有购物车或订单跟踪就关掉对应 enable_* 开关，它会同时移除工具、Prompt 相关行与接地规则，并把相关流程停到 skills/_staged/。
结账走交接而非代付：checkout 只渲染购物车交给宿主完成，或交给平台托管的结账 URL——模型永远看不到卡号。