如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
總覽 智慧體存取權 ChatGPT 與 Codex 使用者文件 使用案例

商品結帳轉換規格

將商品結帳外掛程式整合至 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 的輸入

每個結帳品項只須提供 id 和 quantity。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 所選商家報價的網址。
merchant_name 所選商家的名稱。
price 顯示的報價金額,以字串表示。

images 可包含零個或多個來自所選商家商品資料來源的網址。如果有網址,ChatGPT 會將第一個網址指向的圖片顯示為主圖。若某個選填欄位沒有資料,ChatGPT 會省略該欄位。ChatGPT 不會自行產生商品說明,也不會使用其他商家的商品說明或圖片。請在工具的輸入結構描述中將這些品項欄位宣告為選填,並使用結帳品項識別碼和報價識別碼,從自家商品目錄取得商品、庫存和價格資料。這些資料以自家商品目錄為準。

這個巢狀結帳工作階段採用的資料結構,定義在舊版結帳規格的 create-session 端點中。