代理式商务协议（ACP）

**代理式商务协议（ACP）**是一种交互模型和开放标准，旨在无缝连接买家、其AI代理以及商家，以完成购买流程。

该规范由OpenAI和Stripe共同维护（见[MAINTAINERS.md]），目前处于beta阶段。

• 面向商家：触达更多客户。通过让您的产品和服务可通过AI代理进行购买，吸引高意向买家——同时仍使用您现有的商务基础设施。
• 面向AI代理：将商务功能嵌入您的应用中。允许您的用户在您的应用内直接发现并与商家交易，而无需作为实际的交易主体。
• 面向支付服务商：提升交易量。通过AI代理在买家与商家之间传递安全的支付令牌，处理代理式交易。

更多信息请访问agenticcommerce.dev。

---

📦 仓库结构

rfcs/
├── rfc.agentic_checkout.md
├── rfc.capability_negotiation.md
├── rfc.payment_handlers.md
├── rfc.seller_backed_payment_handler.md
├── rfc.extensions.md
├── rfc.discount_extension.md
└── ...

spec/
├── 2025-09-29/              # 初始发布
├── 2025-12-12/              # 履行增强
├── 2026-01-16/              # 能力协商
├── 2026-01-30/              # 扩展、折扣、支付处理器
└── unreleased/              # 当前开发中

examples/
├── 2025-09-29/
├── 2025-12-12/
├── 2026-01-16/
├── 2026-01-30/
└── unreleased/

changelog/
├── 2025-09-29.md
├── 2025-12-12.md
├── 2026-01-30.md
└── unreleased/              # 各版本变更日志条目（当前开发中）

docs/
├── governance.md
├── principles-mission.md
└── sep-guidelines.md

legal/cla/
├── INDIVIDUAL.md
├── CORPORATE.md
└── SIGNATORIES.md

---

🔗 快速链接

规范类型	最新稳定版	描述
RFC（Markdown）	rfcs/	人类可读的设计文档，包含背景、流程及发布计划。
OpenAPI（YAML）	spec/2026-01-30/openapi/	机器可读的HTTP API规范，用于集成结账端点。
JSON Schema	spec/2026-01-30/json-schema/	用于有效载荷、事件和可重用对象的数据模型。
示例	examples/2026-01-30/	示例请求与响应。
变更日志	changelog/	API版本历史及破坏性变更记录。

---

📅 版本控制

ACP采用基于日期的版本号格式，形式为YYYY-MM-DD。每个版本代表该时间点上规范的完整快照。

版本结构

目录	用途
spec/<version>/	已发布版本的完整规范快照
spec/unreleased/	当前开发中（尚未发布）
examples/<version>/	与各规范版本对应的示例
changelog/<version>.md	每个版本的发布说明

版本生命周期

1. unreleased/ - 新功能和更改在此处开发。
2. 已发布 - 准备就绪时，将unreleased/快照为一个带日期的版本（例如，2026-01-16/）。
3. 已弃用 - 较旧的版本仍可使用，但在变更日志中会被标记为已弃用。

---

🛠 开始使用

ACP已由OpenAI和Stripe率先实现，为商家和开发者提供了生产就绪的参考实现：

• OpenAI文档
• Stripe代理式商务文档

开始构建ACP：

1. 查阅本仓库的OpenAPI规范和JSON Schema以获取最新稳定版本。
2. 选择一个参考实现：
   • 使用OpenAI的实现来集成ChatGPT及其他AI代理界面。
   • 使用Stripe的实现来利用其支付和商家工具。
3. 按照链接文档中的指南操作。
4. 使用本仓库提供的示例进行测试。

---

📚 文档

领域	资源
结账API规范	spec/2026-01-30/openapi/openapi.agentic_checkout.yaml
委托支付规范	spec/2026-01-30/openapi/openapi.delegate_payment.yaml
治理	docs/governance.md
项目原则	docs/principles-mission.md
SEP指南	docs/sep-guidelines.md

---

📝 贡献

我们欢迎贡献！请参阅CONTRIBUTING.md了解：

• 分支模型
• 拉取请求模板和指南
• 规范版本管理和评审流程
• 社区准则

拉取请求模板

创建PR时，请选择合适的模板：

• SEP提案 - 用于重大协议变更、破坏性变更或流程变更。
• 小改进 - 用于文档修复、错误修正或工具改进。

有关哪些内容需要SEP，请参阅docs/governance.md。

贡献者许可协议（CLA）

所有贡献者必须签署CLA后方可接受其贡献。

• 个人贡献者：首次提交PR时，将通过CLA Assistant自动完成。
• 企业贡献者：请参阅企业CLA流程。

查看已签署的CLA | 了解更多关于我们的CLA

所有更改必须包含：

• 更新的 OpenAPI / JSON 模式（如适用）
• 新的或更新的示例
• changelog/unreleased/ 中的变更日志条目文件（详情请参阅 CONTRIBUTING.md）

---

🏛 治理

ACP 由 OpenAI 和 Stripe 作为创始维护者共同治理，并已规划出一条通往更广泛社区治理的清晰路径。

• 治理模式：docs/governance.md
• 项目原则：docs/principles-mission.md
• 维护者：MAINTAINERS.md
• 决策流程：基于共识，辅以升级机制
• 未来方向：随着生态系统的成熟，将过渡到中立基金会的托管管理

---

🤝 社区

• 行为准则：CODE_OF_CONDUCT.md
• 讨论区：GitHub Discussions
• 问题追踪：报告 bug 或请求功能
• SEP 提案：提出协议增强建议

---

📜 许可证

根据 Apache 2.0 许可证授权。

Agentic Commerce Protocol (ACP) 快速上手指南

Agentic Commerce Protocol (ACP) 是由 OpenAI 和 Stripe 共同维护的开放标准，旨在连接买家、AI 代理和商家，实现无缝的自动化购物流程。本指南将帮助开发者快速了解如何基于 ACP 构建集成。

环境准备

ACP 是一个协议规范，而非单一的可执行软件包，因此没有特定的操作系统限制。开发前请确保具备以下环境和依赖：

• 操作系统：Linux, macOS 或 Windows（支持 Git 和现代开发工具即可）。
• 基础工具：
  • git：用于克隆仓库和管理版本。
  • curl 或 wget：用于测试 API 端点。
  • 代码编辑器（如 VS Code）及 YAML/JSON 插件。
• 前置依赖：
  • OpenAI 开发者账号：若需集成 ChatGPT 或其他 AI Agent 表面。
  • Stripe 账号：若需处理支付流程和商户工具。
  • API 客户端工具（可选）：如 Postman 或 Insomnia，用于导入 OpenAPI 规范进行测试。

注意：目前官方文档主要面向全球开发者，暂无专属中国镜像源。国内开发者访问 agenticcommerce.dev 或 GitHub 仓库时，如遇网络延迟，建议使用通用的 GitHub 加速方案。

安装步骤

由于 ACP 是协议标准，"安装"过程实质是获取最新的规范定义文件（OpenAPI specs 和 JSON Schemas）并集成到您的项目中。

1. 克隆官方仓库 获取包含最新规范、示例和文档的源代码：

   git clone https://github.com/agentic-commerce-protocol/agentic-commerce-protocol.git
   cd agentic-commerce-protocol
   

2. 获取最新稳定版规范 当前最新稳定版本为 2026-01-30。您可以直接引用仓库中的文件，或将其复制到您的项目配置目录：

   # 查看 OpenAPI 规范 (Checkout & Payment)
   ls spec/2026-01-30/openapi/
   
   # 查看数据模型 JSON Schema
   ls spec/2026-01-30/json-schema/
   

3. 集成参考实现（二选一） 根据您的需求选择接入路径，无需重新发明轮子：

   • 路径 A (AI 侧)：阅读 OpenAI Commerce Docs 以在 Agent 中嵌入购物能力。
   • 路径 B (商户/支付侧)：阅读 Stripe Agentic Commerce Docs 以配置接收来自 AI 的订单和支付。

基本使用

以下是最简单的集成流程示例，展示如何利用仓库中的资源验证协议连通性。

1. 验证 API 规范

使用 curl 检查本地仓库中的 OpenAPI 定义文件是否完整（以结账接口为例）：

cat spec/2026-01-30/openapi/openapi.agentic_checkout.yaml | head -n 20

2. 模拟请求测试

参考仓库提供的示例数据，构造一个符合 ACP 标准的 JSON 负载。以下是基于 examples/2026-01-30/ 目录结构的逻辑示例：

# 假设您已启动了一个兼容 ACP 的本地测试服务
# 使用示例中的 request 数据进行 POST 请求

curl -X POST http://localhost:8080/v1/checkout \
  -H "Content-Type: application/json" \
  -d @examples/2026-01-30/checkout/request_example.json

3. 开发迭代

如果您计划贡献新功能或适配新特性，请在 spec/unreleased/ 目录下查看正在开发的规范，并在 changelog/unreleased/ 中记录变更：

# 查看正在开发中的特性
ls spec/unreleased/

# 创建新的变更日志条目 (遵循 CONTRIBUTING.md 规范)
echo "- Added support for custom discount logic" > changelog/unreleased/my-feature.md

完成开发后，请参照 CONTRIBUTING.md 提交 Pull Request。