Commerce Agents教程：Anthropic官方购物Agent蓝图，双Agent架构开箱即用

📌 项目日期：2026年9月 | 数据来源：GitHub官方仓库 | 星数：1,866+

📋 项目简介

Commerce Agents 是 Anthropic 官方开源的电商 Agent 参考实现，刚上线就冲上 GitHub Trending，星数逼近两千。它包含两个基于 Claude 构建的商务 Agent：购物Agent（商家嵌入自家App给顾客用）和商家Agent（员工用来管理后台运营）。每个 Agent 只需定义一次——提示词、技能、工具契约、审批门控——即可跑在 Messages API、Claude Agent SDK 和 Managed Agents 三套运行时上。

项目最值得学的是它的安全边界设计：所有公司、品牌、商品全是虚构的演示数据；checkout 只渲染购物车交给宿主应用完成支付，商家侧的每个写操作都先暂存、等人工批准才落地。想深入 Agent 架构设计，可以结合 Hermes自我进化Agent教程 一起看；官方技能体系的用法则参考 Anthropic官方Skills库指南。

🔧 核心功能

📦 安装部署

# 环境要求：Python 3.11+ 与 Node 22
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        # 七个包及固定版本依赖
cp .env.example .env                   # 填入 ANTHROPIC_API_KEY
(cd examples && npm ci)                # 八个Web应用共享一个workspace

# 运行零售行业Demo（API :8000 + 店铺前端 :3000）
python scripts/run_demo.py retail

# 商家后台门户（:3100）或双端同时启动
python scripts/run_demo.py retail --merchant
python scripts/run_demo.py retail --all

四个行业对应不同端口：retail（:3000/:3100）、travel（:3001/:3101）、telecom（:3002/:3102）、entertainment（:3003/:3103），每个子目录的 README 都给了两端可试的提示词。

🛠️ 用Claude Code脚手架搭自己的Agent

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

/scaffold-commerce-agent 会询问你的技术栈、回放执行计划再动手建项目；/add-commerce-flow 与 /author-commerce-evals 用于追加业务流与评测；已有 Agent 则用 /review-commerce-agent 做体检。

💡 使用建议

• 把它当参考蓝图而不是产品：工具契约、门控、暂存审批这三层设计任何电商Agent都用得上
• 先跑通 retail Demo 再读代码，对照界面理解双Agent的协作边界
• 接入真实系统时，把 checkout 渲染与人工审批机制原样保留，合规责任在部署方
• 自建Agent前先用 /review-commerce-agent 审一遍现有实现，少走弯路