For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主导航

商品结账转化规范

将商品结账插件集成到 ChatGPT 转化流程的接口约定。

ChatGPT 中的商品结账转化插件目前处于测试阶段,正在 与获准参与的合作伙伴一起测试。如需申请访问权限,请填写此表单

点此访问

目的

我们的目标是让 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 输入

每个结账商品项只需提供 idquantity。所选商家报价的 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;第一个为主图。
url所选商家报价的 URL。
merchant_name所选商家的名称。
price以字符串形式表示的所展示报价。

images 包含零个或多个来自所选商家数据源的 URL。 如果存在 URL,第一个 URL 对应主要展示的图片。ChatGPT 会省略无法获取值的 可选字段。它不会生成描述,也不会使用其他商家的 描述或图片。请在工具的输入模式中将这些商品项字段声明为可选字段, 并使用结账商品项 ID 和报价 ID,从您自己的商品目录中获取权威的 商品、库存和定价数据。

嵌套的结账会话与 此处文档中介绍的 Commerce 结账会话结构一致。