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

在地服務「取得報價」轉換流程規格

將在地服務的報價請求外掛程式整合至 ChatGPT 轉換流程時須遵循的介接規格。

ChatGPT 的在地服務「取得報價」轉換流程外掛程式目前處於 Beta 階段,正與獲核准的合作夥伴共同測試。如要申請使用,請填寫 ChatGPT 商家表單。

用途

當使用者有明確意願使用在地服務,例如想向商家索取報價時,ChatGPT 可以直接呼叫合作夥伴的外掛程式。

若要啟用這項流程,請提供可識別您所提供服務的在地商家資料,並提供可開啟報價請求小工具的 MCP 工具。

如要依照本規格開發外掛程式,請透過 ChatGPT 商家表單申請使用。

使用者體驗

當使用者搜尋符合資格的在地商家時,商家資訊卡或側邊欄可以顯示「取得報價」按鈕。使用者選取按鈕後,ChatGPT 會在強制回應視窗中開啟服務供應商的報價請求小工具。

只有當商家有符合資格的服務供應商,且該供應商已設定合作夥伴外掛程式時,ChatGPT 才會顯示按鈕。

必要介接規格

註冊名為 request_service 的 MCP 工具,並將 ui://widget/request-service.html 設為其小工具資源。當使用者選取「取得報價」時,ChatGPT 會以 modal 顯示模式啟動小工具,並將供應商的商家 ID 傳給啟動工具:

const launcherTool = {
  name: "request_service",
  _meta: {
    ui: {
      resourceUri: "ui://widget/request-service.html",
    },
  },
};

const launcherInput = {
  business_id: "biz_123",
};

對於小工具會直接呼叫的每個輔助工具,請設定 _meta["openai/widgetAccessible"] = true。這項中繼資料適用於小工具可存取的輔助工具。啟動工具若只是負責開啟小工具,就不需要這項設定。

傳給啟動工具的 business_id 必須是對應服務供應商記錄中的 provider_business_id。這個值可以與該供應商記錄所屬的在地商家記錄 ID 不同。

商家資料饋送要求

商家資料饋送是您分頁提供給 ChatGPT 的一組在地商家記錄。ChatGPT 會為這些記錄建立索引以供搜尋,並根據其中的服務供應商資料,判斷商家是否支援「取得報價」。

商家必填欄位

每筆商家記錄都必須包含下列欄位:

  • id:固定不變且在您的資料饋送中不重複的商家 ID。
  • name:商家名稱。
  • address:結構化地址,或已排成易讀格式的地址。
  • location:包含 latitude 和 longitude 的物件。
  • phone_number:商家電話號碼,建議使用 E.164 格式。
  • website_url:商家網站網址。
  • platform_url:該商家在您平台上的商家頁面標準網址。

報價請求動作

對於每家接受報價請求的商家,請新增 service_providers 陣列,並在陣列中加入一筆含有下列欄位的記錄:

  • provider:您的供應商名稱,必須與合作夥伴外掛程式設定的供應商名稱相符。
  • provider_business_id:您用來識別該商家的 ID,不得為空。ChatGPT 會將此值作為 business_id 傳給 request_service。
  • action_type:如為報價請求,請設為 request_a_quote。
  • provider_action_url:報價請求動作的網址,必須是有效的 HTTP 或 HTTPS 絕對網址。
  • display_name:由供應商提供的顯示名稱,可省略。

商家清單分頁端點

提供商家清單端點,例如 GET /v1/businesses,並支援下列其中一種分頁方式:

  • page 和 page_size。
  • offset 和 limit。
  • 不透明的 next_page_token。

端點須接受選用的 changes_token 參數,用來識別上一次同步的檢查點。回應須以 checksum 指出資料饋送是否有變更,以 businesses 列出目前這一頁的商家,並附上所用分頁方式的中繼資料。

例如,下列請求會從按頁碼分頁的資料饋送中擷取一筆商家記錄:

GET /v1/businesses?page=1&page_size=1&changes_token=sync_001

請傳回完整的商家記錄,其中須包含報價請求動作:

{
  "checksum": true,
  "page": 1,
  "page_size": 1,
  "total_pages": 1,
  "businesses": [
    {
      "id": "local_biz_456",
      "name": "Acme Plumbing",
      "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://acmeplumbing.example",
      "platform_url": "https://provider.example/businesses/local_biz_456",
      "service_providers": [
        {
          "provider": "example_provider",
          "provider_business_id": "biz_123",
          "action_type": "request_a_quote",
          "provider_action_url": "https://provider.example/request-quote/biz_123",
          "display_name": "Get Quote"
        }
      ]
    }
  ]
}

啟動報價流程的條件

只有在下列條件都成立時,ChatGPT 才會在對話中建立啟動按鈕:服務供應商記錄所屬的商家 ID 不為空、供應商的 provider_business_id 不為空、provider_action_url 有效,且供應商已設定合作夥伴外掛程式。報價按鈕使用 ChatGPT 的介面標籤「取得報價」。供應商的 display_name 不會覆寫 request_a_quote 動作的按鈕標籤。

後續擴充

本規格涵蓋報價請求。報價請求流程不需要支援其他服務動作,例如預約服務。