Claude Commerce Agents

Anthropic 正式发布了 anthropics/commerce-agents，这是一个基于 Apache 2.0 许可证 开源的参考实现框架。它不仅仅是一组代码示例，更是一套经过实战验证的、用于构建零售、旅行、电信和娱乐领域购物与商家代理的完整基础设施蓝图。该框架旨在解决开发团队在构建商业代理时重复造轮子的问题，提供了从代理循环、工具层到评估套件的全套解决方案。

核心架构：双代理模型与技能系统

该蓝图定义了两种核心代理角色，并引入了创新的“技能（Skills）”架构来替代传统的子代理模式：

1. 🛒 购物代理 (Shopper Agent)

面向消费者，运行在商家应用中，具备五大核心技能：

• Search & Discovery：搜索目录，发现商品。
• Purchase Research：比较选项，处理多商品请求。
• Planning & Goals：根据用户目标规划购买方案。
• Customer Care：处理订单查询、退货及售后问题。
• Memory & Personalization：记住用户偏好，提供个性化推荐。

2. 💼 商家代理 (Merchant Agent)

面向商店员工，辅助运营决策，具备五大核心技能：

• Performance Insights：分析销售业绩。
• Catalog Listings：管理商品上架与信息。
• Inventory Operations：监控库存警报与补货。
• Pricing & Promotions：提供定价策略与促销建议。
• Marketing Campaigns：起草营销活动文案。

关键技术创新

“技能”优于“子代理”

Anthropic 强烈反对为每个领域创建独立子代理并通过意图路由器分发的传统做法。

• 痛点：子代理间的状态交接是有损的，且每次切换都会消耗大量令牌并增加延迟。
• 解决方案：使用代理技能（Agent Skills）。所有技能指令加载到同一个持有完整对话历史的代理中。
• 优势：在多项企业部署测试中，单代理+技能模式在质量、成本和延迟上均优于“大提示词”设计和子代理编排设计。

UI 组件即工具 (UI Components as Tools)

商业交互的核心是结构化数据而非纯文本。

• 类型化工具：将 present_products、present_itinerary 等 UI 组件定义为带有类型化参数的工具。
• 原生历史支持：由于这些调用原生存在于消息数组中，重新加载对话历史时无需自定义解析器，代理可以直接从历史记录中解析出“第一家酒店”或“第三个商品”。
• 服务器端验证：客户端渲染前由服务器验证参数，确保数据一致性。

极致性能优化

• 急切工具分发 (Eager Tool Dispatch)：在 Agent SDK 默认行为下，一旦参数流式传输完成即刻执行工具调用，将数秒的等待间隙缩短至几百毫秒。
• 提示缓存策略：通过精心安排请求顺序（全局 → 会话 → 易变），实现 90–99% 的缓存命中率。缓存读取成本仅为新鲜令牌的十分之一。
• 异步内存提取：在独立进程中运行事实提取，召回率比轮内保存工具高出 13%。

部署与兼容性

• 开源许可：Apache 2.0，允许自由修改和商业使用。
• 运行环境：Python 3.11+ 和 Node 22。
• 模型后端兼容：虽然专为 Claude 设计，但代码接受任何 anthropic 客户端，因此可无缝部署在 Claude API、Amazon Bedrock、Microsoft Foundry 或 Google Cloud Vertex AI 上。
• Claude Code 插件：提供 commerce-builder 插件，支持通过 /scaffold-commerce-agent 快速搭建新代理或通过 /review-commerce-agent 审查现有代码。

安全与门控

• 代码级门控：金钱交易、数据写入和 ID 操作必须在代码层面进行严格门控。模型仅负责“提议”，框架负责“执行”和“验证”，确保商业逻辑的绝对安全。
• 品牌约束：安全规则和品牌约束始终放在系统提示的最前端，确保不被覆盖。