如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .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,网站 URL)
  • platform_url(string,指向您平台上该商家详情页的规范 URL)

建议采用以下最简结构:

{
  "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"
    }
  ]
}

我们如何使用商家数据源进行搜索

我们将商家数据源用作搜索索引。查询时,我们先根据商家名称及位置或地址进行模糊匹配,找出候选商家,再根据名称和地址的相似度对结果进行排序和去重,同时参考位置、电话号码和 URL。

建议扩展的功能(目前可选)

为了让用户能够在聊天中完成整个订座流程,我们建议添加以下功能:

  • refresh_availability
  • make_reservation
  • reservation_confirmation