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

> 一个完整的多服务演示项目，展示如何使用Stripe的Agentic Commerce Protocol (ACP)、大语言模型函数调用和Temporal持久化工作流来构建代理中介的电商系统。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-16T01:20:32.000Z
- 最近活动: 2026-04-16T01:24:41.347Z
- 热度: 141.9
- 关键词: AI代理, 电商, Stripe ACP, Temporal, 工作流, 大语言模型, 支付系统, 概念验证
- 页面链接: https://www.zingnex.cn/forum/thread/agent-commerce-poc-acp
- Canonical: https://www.zingnex.cn/forum/thread/agent-commerce-poc-acp
- Markdown 来源: ingested_event

---

## 背景与动机

随着大语言模型能力的不断提升，AI代理在电商领域的应用越来越受到关注。传统的电商系统依赖用户手动浏览商品、填写订单、完成支付，而AI代理可以通过自然语言对话理解用户需求，自动完成整个购买流程。

然而，将AI代理与真实支付系统集成面临诸多挑战：安全性、事务一致性、错误恢复、退款处理等。agent-commerce-poc项目正是为了解决这些问题而设计的概念验证系统。

## 项目概述

agent-commerce-poc是一个多服务架构的演示项目，展示了如何使用Stripe的Agentic Commerce Protocol (ACP)构建代理中介的电商系统。该系统包含以下核心组件：

- **Seller API (端口8000)**：基于FastAPI的ACP结账端点，处理Stripe支付和SQLite代币账本
- **Agent (端口8080)**：Python + OpenAI实现的LLM编排器，支持函数调用工具
- **Web UI (端口5173)**：React分屏界面，左侧为UI购买，右侧为代理聊天
- **Temporal Server (端口7233)**：持久化工作流引擎，处理结账生命周期
- **Temporal Worker**：执行结账工作流（支付、履约、退款）

## 核心架构设计

### 代理与人工并行路径

该系统的一个关键设计是支持两种购买路径：

1. **代理路径**：用户通过自然语言与AI代理对话，代理理解需求后调用ACP工具完成购买
2. **传统UI路径**：用户通过React界面手动选择商品并完成结账

两种路径最终都调用相同的Seller API和Stripe账户，确保业务逻辑的一致性。

### Temporal持久化工作流

结账流程使用Temporal工作流引擎实现持久化执行，确保即使在系统故障时也能恢复状态：

```
创建PaymentIntent → 确认支付 → 履约（代币入账+Stripe信用授予）→ 等待退款信号 → 退款（如触发）
```

工作流支持24小时退款窗口，期间可以接收退款请求并自动处理。如果Temporal不可用，系统会自动回退到内联支付路径。

### ACP工具集

代理通过ACP工具与Seller API交互：

- `list_catalog`：列出商品目录
- `create_checkout`：创建结账会话
- `complete_checkout`：完成结账
- `get_balance`：查询代币余额
- `cancel_checkout`：取消结账

同时代理也可以直接调用Stripe API查询产品、价格、支付意图等信息。

## 代币经济模型

系统采用代币包模式进行商品定价：

- 10/25/50/100积分包 + 单代币
- 用户购买代币包后，Seller API维护SQLite账本记录余额
- 消费时从账本扣除代币
- 支持退款时自动回滚账本和Stripe信用

这种设计允许灵活的定价策略，同时保持支付系统的简洁性。

## 技术亮点

### 102项集成测试

项目包含完整的测试套件，覆盖：
- 商品目录测试（5项）
- 余额管理测试（10项）
- 结账流程测试（17项）
- 退款测试（6项）
- 策略验证（11项）
- 边界情况（14项）
- 代理场景（39项）

### 多代理场景测试

代理场景测试包含32个参数化的多轮对话测试，验证代理在不同用户意图下的行为，以及7个针对性断言确保关键业务逻辑正确。

## 部署与运行

项目使用Docker Compose编排所有7个服务，首次启动约需60秒。配置通过环境变量管理，需要：

- Stripe测试模式密钥
- OpenAI API密钥
- Docker Desktop（分配4GB+内存）

## 实际意义与启示

agent-commerce-poc展示了AI代理电商系统的关键设计模式：

1. **协议标准化**：使用Stripe ACP标准化代理与支付系统的交互
2. **工作流持久化**：Temporal确保复杂业务流程的可靠性
3. **双路径设计**：同时支持代理和传统UI，降低用户采纳门槛
4. **完整测试覆盖**：102项测试确保系统稳定性

对于希望在自己的产品中集成AI代理电商功能的开发者，这个项目提供了可运行的参考实现和最佳实践。

## 结语

agent-commerce-poc不仅是一个技术演示，更是AI代理电商领域的探索性工作。它展示了如何将大语言模型、支付系统、工作流引擎整合为一个完整的用户-facing系统，为未来的AI原生电商应用奠定了基础。