如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
概览 智能体访问 ChatGPT 与 Codex 用户文档 使用场景

商品结账转化规范

将商品结账插件接入 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 的输入

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

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

嵌套的结账会话采用旧版结账规范中为创建会话端点定义的数据结构。