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 動作的按鈕標籤。
後續擴充
本規格涵蓋報價請求。報價請求流程不需要支援其他服務動作,例如預約服務。