什么是智能商务？
智能商务代表着消费者发现、评估和购买产品方式的根本性转变。消费者不再浏览网站、点击菜单和填写结账表单，而是将购买决策委托给代表他们行事的 AI 代理。Shopify 将自己定位在这场变革的中心，构建基础设施让世界上任何 AI 代理都能销售任何 Shopify 商家的任何产品。
智能商务并非遥远的未来概念。截至 2025 年，Shopify 已发布生产级 API，让 ChatGPT、Microsoft Copilot 和 Perplexity 等 AI 代理能够浏览产品目录、将商品添加到购物车并完成购买——整个过程无需买家访问传统店面。
Shopify 愿景
Shopify CEO Tobi Lutke 将智能商务描述为零售业的第三次重大渠道变革：
- 实体零售 -- 客户走进商店
- 电子商务 -- 客户浏览网站
- 智能商务 -- AI 代理代表客户购物
核心论点很简单：如果 AI 助手能理解客户想要什么、搜索数十亿产品、比较选项并在几秒内完成购买，那么传统店面就只是商务发生的众多界面之一。
Shopify Catalog API
Catalog API 是智能商务的基础。它提供了一个统一的、可搜索的产品索引，覆盖数百万 Shopify 商家，通过单一接口向 AI 代理暴露数十亿个产品。
Catalog API 的工作原理
与传统的 Storefront API（仅限于单个商店）不同，Catalog API 在平台级别运作。AI 代理不需要知道哪个商家销售跑鞋——它只需带着客户的意图查询 Catalog API，即可从整个 Shopify 生态系统中接收相关产品。
# Example: Searching the Shopify Catalog API
query SearchProducts {
catalog {
search(
query: "organic cotton t-shirt"
filters: {
priceRange: { min: 20, max: 60 }
availability: IN_STOCK
}
first: 10
) {
edges {
node {
title
description
vendor
priceRange {
minVariantPrice {
amount
currencyCode
}
}
images(first: 1) {
edges {
node {
url
altText
}
}
}
checkoutUrl
}
}
}
}
}
核心能力
| Feature | Description |
|---|---|
| Semantic Search | Natural language product discovery powered by ML embeddings |
| Faceted Filtering | Price, availability, location, category, and custom attribute filters |
| Real-time Inventory | Live stock levels synchronized across all merchant channels |
| Merchant Quality Signals | Ratings, fulfillment speed, return policies surfaced to agents |
| Multi-currency | Automatic price conversion for global commerce |
Catalog API 使用基于游标的分页。始终存储每个响应中的 endCursor，并在后续请求中将其作为 after 参数传递。这对于构建需要分页浏览大型结果集的代理至关重要。
Checkout Kit
Checkout Kit 是 Shopify 的客户端库，让 AI 代理能够完成购买而无需将用户重定向到传统的网页结账。它支持多个平台：
- JavaScript (web and Node.js agents)
- Swift (iOS agents and Apple Intelligence integrations)
- Android/Kotlin (Google Assistant and Android agents)
- React Native (cross-platform mobile agents)
import { CheckoutKit } from '@shopify/checkout-kit-js';
// Initialize Checkout Kit with agent credentials
const checkout = new CheckoutKit({
storefrontAccessToken: process.env.SHOPIFY_STOREFRONT_TOKEN,
domain: 'merchant-store.myshopify.com',
});
// Create a cart from agent-selected products
const cart = await checkout.createCart({
lines: [
{
merchandiseId: 'gid://shopify/ProductVariant/12345',
quantity: 1,
},
],
buyerIdentity: {
email: 'customer@example.com',
countryCode: 'US',
},
});
// Generate a checkout URL or embed checkout inline
const checkoutUrl = cart.checkoutUrl;
Checkout Kit 使用 Storefront API 访问令牌，这是可以安全嵌入在客户端代码中的公开令牌。永远不要在面向代理的代码中暴露你的 Admin API 令牌。Storefront 令牌的权限范围确保代理只能执行面向买家的操作。
智能体式店面
智能体式店面是 AI 代理展示产品和促成购买的界面。Shopify 商家不需要为每个代理平台构建自定义集成——Shopify 负责处理底层管道。
当前支持的代理平台
ChatGPT Shopping：OpenAI 的 ChatGPT 可以浏览 Shopify 的产品目录、显示带有图片和定价的产品卡片，并直接链接到结账。一旦商家的产品被索引，他们就会自动出现在 ChatGPT 购物结果中。
Microsoft Copilot：通过 Copilot Commerce 集成，Shopify 产品出现在 Copilot 搜索结果和对话式回复中。该集成支持带有购买按钮的富产品卡片。
Perplexity Shopping：当用户提出购物相关问题时，Perplexity 的答案引擎会展示带有直接购买链接的 Shopify 产品。
自定义代理：任何开发者都可以使用 Catalog API 和 Checkout Kit 构建购物代理。这是本课程中开发者真正的机会所在。
AI 购物开发者仪表盘
Shopify 在合作伙伴仪表板中提供了专门的区域，用于监控和管理智能商务集成。
仪表盘功能
- 代理分析：追踪哪些 AI 代理正在带来流量和转化
- 产品数据源健康度：监控你的产品在 Catalog API 索引中的表现
- 转化漏斗：查看从代理发现到结账完成的流失率
- 代理专属优化：A/B 测试针对 AI 理解能力优化的产品描述
- 收入归因：了解来自代理驱动购买与传统渠道的收入占比
Catalog API 目前处于受控推出阶段。并非所有商家都会自动被索引。商家必须满足一定的质量门槛（活跃商店、有效的运费设置、清晰的产品数据）才能出现在代理搜索结果中。请在合作伙伴仪表板中查看你的商店索引状态。
开发者机遇
作为开发者，智能商务开辟了几个新的应用类别：
- 自定义购物代理 -- 为细分市场构建专用代理（例如，一个葡萄酒品酒师代理，为客户推荐 Shopify 葡萄酒商家的酒款）
- 代理优化工具 -- 帮助商家优化其产品数据以便 AI 发现
- 多代理编排 -- 构建协调多个专用代理以完成复杂购买决策的系统
- 代理分析平台 -- 为商家提供更深入的代理驱动商务洞察
本模块你将构建什么
在本模块中，你将构建一个完整的智能商务流水线：
- 查询 Catalog API 以基于自然语言发现产品
- 使用 Claude 作为 AI 骨干构建对话式购物流程
- 集成 Checkout Kit 以编程方式完成购买
- 部署一个跨多个界面工作的自定义购物代理
继续学习下一课 Sidekick 扩展，了解如何为商家扩展 Shopify 内置 AI 助手的自定义功能。