anthropics/commerce-agents

它解决了什么问题

这个项目提供了一个构建AI驱动的电商体验的参考实现。它解决了创建专用代理（agent）的挑战，这些代理既能处理面向客户的购物任务，又能处理内部业务运营（如商家管理），同时保持安全性、设置防护机制，并与现有的业务系统集成。

它如何工作

该系统包含两个主要的代理角色：

• 购物代理：一个面向客户的助手，负责处理产品搜索、比较、规划、购物车管理以及政策咨询。它使用 StorefrontBackend 与公司的商品目录和订单系统进行交互。
• 商家代理：一个后台工具，供员工分析业绩、更新商品列表、管理库存以及起草营销活动。为确保安全，所有“写入”操作（更改）都会先暂存，必须经过人工审批后才能应用。

这些代理可以通过三种方式部署：通过 Messages API（用于自定义主机应用）、Agent SDK（由SDK管理的循环）或作为 托管代理（使用MCP服务器）。

适合谁使用

• 开发者：希望构建AI购物助手或商家门户的开发者。
• 企业：希望实施基于大语言模型（LLM）的电商自动化，并内置安全防护机制的企业。
• 架构师：设计大语言模型与电商后端（商品目录、购物车和分析系统）之间集成方案的架构师。

主要亮点

• 双角色架构：为客户和商家分别设计专用代理。
• 安全优先：包含防护机制、来源验证门禁，以及商家变更的强制人工审批流程。
• 灵活部署：支持多种运行时环境，包括Messages API、Agent SDK和托管代理。
• 行业垂直领域：包含四个可运行的示例，涵盖零售、旅游、电信和娱乐行业。
• 脚手架工具：包含一个Claude Code插件，帮助开发者基于自身技术栈快速搭建新的电商代理。

"This project is a blueprint for building safe, scalable AI agents in commerce." — @jameskyle