什麼是代理式商務？

代理式商務代表了一個根本性的轉變消費者在線上發現、評估和購買商品的方式。消費者不再瀏覽網站、點擊選單和填寫結帳表單，而是將購買決策委託給代表他們行動的 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 在 Partner Dashboard 中提供了專門的區段，用於監控和管理代理式商務整合。

儀表板功能

代理分析：追蹤哪些 AI 代理正在推動流量和轉換
產品 Feed 健康度：監控您的產品在 Catalog API 索引中的呈現方式
轉換漏斗：查看從代理發現到結帳完成的流失率
代理專用最佳化：A/B 測試針對 AI 理解最佳化的產品描述
收入歸因：了解來自代理驅動購買與傳統渠道的收入百分比

重要限制

Catalog API 目前處於受控推出階段。並非所有商家都會自動被索引。商家必須達到特定的品質門檻（活躍商店、有效運費、清晰的產品資料）才能出現在代理搜尋結果中。請在 Partner Dashboard 中查看您商店的索引狀態。

開發者機會

作為開發人員，代理式商務開啟了幾個新類別的應用程式：

自訂購物代理 —— 為利基市場建構專業代理（例如，從 Shopify 葡萄酒商家推薦酒款的侍酒師代理）
代理最佳化工具 —— 幫助商家最佳化其產品資料以便 AI 發現
多代理協調 —— 建構協調多個專業代理以處理複雜購買決策的系統
代理分析平台 —— 為商家提供代理驅動商務的更深入洞察

您將在此模組中建構的內容

在本模組中，您將建構一個完整的代理式商務管線：

查詢 Catalog API 以根據自然語言發現產品
使用 Claude 作為 AI 骨幹建構對話式購物流程
整合 Checkout Kit 以程式化方式完成購買
部署可跨多個介面運作的自訂購物代理

下一步

繼續下一課 Sidekick 擴充功能了解如何使用自訂功能為商家擴展 Shopify 的內建 AI 助手。

Shopify 的願景​

Shopify Catalog API​

Catalog API 如何運作​

主要功能​

Checkout Kit​

代理式店面​

目前支援的代理平台​

AI 購物開發者儀表板​

儀表板功能​

開發者機會​

您將在此模組中建構的內容​