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 端點中。