ChatGPT 的餐廳訂位轉換外掛程式目前處於 Beta 階段,我們正與已獲核准的合作夥伴共同測試。如要申請使用,請填寫
申請表單
目的
當使用者有明確意圖,例如想預訂餐廳座位時,我們希望 ChatGPT 能直接呼叫合作夥伴的外掛程式。
合作夥伴提供可供搜尋的資料來源後,我們就能連接其 MCP 伺服器,讓使用者在轉換流程的最後階段執行訂位等操作。為此,合作夥伴的外掛程式必須遵循統一規格,設定小工具名稱、工具名稱及工具輸入。
如要開發符合本規格的外掛程式,請填寫 ChatGPT 商家申請表單。
使用者體驗
使用者搜尋附近的餐廳時,餐廳資訊卡和側邊欄都會顯示「訂位」按鈕。點選按鈕即可開啟該餐廳所用訂位服務的介面。
餐廳介面中的「訂位」按鈕:

點選按鈕後開啟的訂位對話框:

目前必須遵循的規格
現行訂位整合只要求使用以下名稱:
- 小工具名稱:
ui://widget/restaurant-reservation.html - 工具名稱:
restaurant_reservation
restaurant_reservation 必須設定以下屬性:
_meta.ui.resourceUri = "ui://widget/restaurant-reservation.html";
小工具直接呼叫的任何工具都必須設定以下屬性:
_meta["openai/widgetAccessible"] = true;
restaurant_reservation 的輸入
每次呼叫至少會傳送以下資料:
{
"restaurant_id": "string"
}
我們也可能傳送以下資料。你可以利用這些資料在對話框中進行樂觀渲染,例如在完整資料載入前先顯示餐廳資訊,省去骨架畫面或載入提示:
{
"restaurant_name": "string",
"restaurant_image": "string",
"restaurant_address": {
"address": "string",
"city": "string",
"state": "string",
"zipcode": "string",
"country": "string"
}
}
資料來源要求(搜尋整合)
為了讓「訂位」按鈕連到對應的訂位服務,我們會匯入合作夥伴提供的商家資料。
目的與範圍
商家資料來源規格涵蓋以下項目:
- 比對及排序所需的基本商家資料。
- 可分頁列出商家的 API。
- 偵測資料變更的機制,避免在資料未變更時重新擷取全部資料。
商家記錄(必要欄位)
每個 Business 物件至少必須包含以下欄位:
id(string):識別碼必須固定不變,且在同一供應商的資料中不得重複。name(string)address(object或已格式化的string)location(包含經緯度的object)phone_number(string,建議使用 E.164 格式)website_url(string,網址)platform_url(string,商家在你平台上的正式頁面網址)
建議的基本資料結構:
{
"id": "biz_123",
"name": "Acme Coffee",
"address": {
"line1": "123 Market St",
"line2": "Suite 5",
"locality": "San Francisco",
"region": "CA",
"postal_code": "94105",
"country": "US",
"formatted": "123 Market St, Suite 5, San Francisco, CA 94105, US"
},
"location": {
"latitude": 37.793,
"longitude": -122.396
},
"phone_number": "+14155551234",
"website_url": "https://acmecoffee.example",
"platform_url": "https://provider.example/biz/biz_123"
}
如果無法提供結構化地址欄位,address 可以使用單一字串表示完整地址,但格式必須一致且易於閱讀。
分頁列出商家的端點
端點範例:
GET /v1/businesses
查詢參數:
- 分頁:請選用下列一種方式
page+page_sizeoffset+limit- 或
next_page_token(不透明權杖,支援時建議優先使用) changes_token(string,選用):用來判斷自上次同步檢查點以來,資料是否有變更。
回應必須包含:
checksum(boolean):表示自提供的changes_token所對應的檢查點以來,是否有任何資料變更(若未提供權杖,則為true)。businesses(Business[]):本頁的商家資料。- 所選分頁方式對應的中繼資料:
page、page_size、total_pages(選用),或offset、limit、total(選用),或next_page_token(string | null)
請求與回應範例
請求:
GET /v1/businesses?page=1&page_size=2&changes_token=sync_2026_03_10
回應:
{
"checksum": true,
"page": 1,
"page_size": 2,
"total_pages": 120,
"businesses": [
{
"id": "biz_123",
"name": "Acme Coffee",
"address": {
"line1": "123 Market St",
"locality": "San Francisco",
"region": "CA",
"postal_code": "94105",
"country": "US",
"formatted": "123 Market St, San Francisco, CA 94105, US"
},
"location": {
"latitude": 37.793,
"longitude": -122.396
},
"phone_number": "+14155551234",
"website_url": "https://acmecoffee.example",
"platform_url": "https://provider.example/biz/biz_123"
},
{
"id": "biz_124",
"name": "Golden Diner",
"address": "200 Howard St, San Francisco, CA 94105, US",
"location": {
"latitude": 37.789,
"longitude": -122.391
},
"phone_number": "+14155559876",
"website_url": "https://goldendiner.example",
"platform_url": "https://provider.example/biz/biz_124"
}
]
}
如何使用商家資料進行搜尋
我們將商家資料作為搜尋索引。收到查詢時,我們會先依商家名稱及位置或地址進行模糊比對,找出可能符合的商家,再依名稱與地址的相似度排序並移除重複項目。位置、電話號碼和網址也會用於輔助判斷。
建議擴充項目(目前非必要)
如要讓使用者在對話中完成整個訂位流程,建議新增以下工具:
refresh_availabilitymake_reservationreservation_confirmation