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

餐廳訂位轉換規格

將餐廳訂位外掛程式整合至 ChatGPT 訂位流程所需遵循的規格。

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_size
  • offset + 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_availability
  • make_reservation
  • reservation_confirmation