Agent-Commerce-POC：构建基于ACP协议的智能代理电商系统

Agent-Commerce-POC是一个概念验证项目，展示如何使用Stripe的Agentic Commerce Protocol (ACP)、大语言模型函数调用和Temporal持久化工作流构建代理中介的电商系统。项目解决AI代理与真实支付系统集成的安全性、事务一致性等挑战，支持代理对话与传统UI双路径购买，提供完整测试套件与可运行参考实现。

随着LLM能力提升，AI代理在电商领域应用受关注。传统电商依赖用户手动操作，AI代理可通过自然语言对话自动完成购买流程，但集成AI代理与支付系统面临安全性、事务一致性、错误恢复、退款处理等挑战。本项目作为POC旨在解决这些问题。

项目组件

系统采用多服务架构，核心组件包括：Seller API（处理支付与代币账本）、Agent（LLM编排器）、Web UI（双路径界面）、Temporal Server（持久化工作流）、Temporal Worker（执行结账流程）。

双路径设计

支持代理路径（自然语言对话完成购买）与传统UI路径（手动操作），最终调用相同API与Stripe账户，确保逻辑一致。

Temporal工作流

结账流程通过Temporal实现持久化：创建PaymentIntent→确认支付→履约→等待退款信号→退款（如触发），支持24小时退款窗口，故障时自动回退到内联路径。

ACP工具集

代理通过list_catalog、create_checkout等工具与Seller API交互，也可直接调用Stripe API查询信息。

代币经济模型

采用代币包定价（10/25/50/100积分包+单代币），Seller API维护SQLite账本记录余额，消费时扣除，退款时自动回滚。

项目包含102项集成测试，覆盖商品目录（5项）、余额管理（10项）、结账流程（17项）、退款（6项）、策略验证（11项）、边界情况（14项）、代理场景（39项）。其中代理场景测试含32个参数化多轮对话测试及7个针对性断言，确保关键逻辑正确。

项目使用Docker Compose编排7个服务，首次启动约60秒。配置需通过环境变量管理，需准备：Stripe测试模式密钥、OpenAI API密钥、Docker Desktop（分配4GB+内存）。

本项目展示AI代理电商系统的关键设计模式：协议标准化（Stripe ACP）、工作流持久化（Temporal）、双路径设计、完整测试覆盖。为开发者提供可运行参考实现与最佳实践，是AI代理电商领域的探索性工作，为未来AI原生电商应用奠定基础。