For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽

商品結帳轉換規格

將商品結帳外掛程式整合至 ChatGPT 轉換流程的規範。

ChatGPT 的商品結帳轉換外掛程式目前處於 Beta 階段,並正與 核准的合作夥伴進行測試。如需申請使用權限,請填寫此表單

點此前往

目的

我們的目標是讓 ChatGPT 直接呼叫合作夥伴的外掛程式,以支援商品結帳等使用者意圖明確的使用案例。

合作夥伴提供可供搜尋的商品資料饋送後,我們就能連接其 MCP 伺服器,執行轉換漏斗底部的動作。為此,合作夥伴的外掛程式必須遵循標準化規範,設定小工具名稱、工具名稱和工具輸入。

如果你想建立符合此規格的外掛程式,請透過 ChatGPT 商家表單申請使用權限。

使用者體驗

使用者搜尋商品時,商品實體側邊欄可為賣家顯示 開啟 按鈕。如果賣家有外掛程式,ChatGPT 就能直接在目前介面中開啟該外掛程式 進行結帳,而不必跳轉至外部網站。

必要規範(目前)

  • 小工具名稱:ui://widget/checkout-session.html
  • 工具名稱:checkout_session

checkout_session 必須設定:

_meta.ui.resourceUri = "ui://widget/checkout-session.html";

任何由小工具直接呼叫的工具都必須設定:

_meta["openai/widgetAccessible"] = true;

checkout_session 輸入

每個結帳品項只需要 idquantity。所選商家報價的 offerId 和 中繼資料皆為選填:

{
  "checkout_session": {
    "items": [
      {
        "id": "string",
        "quantity": 1,
        "offerId": "string",
        "name": "Wireless headphones",
        "description": "Wireless headphones with noise cancellation.",
        "images": [
          "https://merchant.example.com/images/headphones.jpg",
          "https://merchant.example.com/images/headphones-side.jpg"
        ],
        "url": "https://merchant.example.com/products/headphones",
        "merchant_name": "Example Merchant",
        "price": "$24.99"
      }
    ]
  }
}

以下品項欄位皆為選填:

欄位說明
offerId所選商家報價的識別碼。
name所選報價的商品名稱。
description來自商家自身資料饋送的描述。
images商家資料饋送中依序排列的圖片 URL;第一個為主要圖片。
url所選商家報價的 URL。
merchant_name所選商家的名稱。
price以字串表示的顯示報價金額。

images 包含零個或多個來自所選商家資料饋送的 URL。 若有提供 URL,第一個就是主要顯示圖片。ChatGPT 會省略無法取得的 選填欄位,不會生成描述,也不會使用其他商家的 描述或圖片。請在工具的輸入結構描述中將這些品項欄位宣告為選填, 並使用結帳品項和報價的 ID,從你自己的商品目錄擷取 權威的商品、庫存和定價資料。

巢狀結帳工作階段的結構,與 此處文件所述的 Commerce 結帳工作階段結構一致。