結(jié)構(gòu)化檢索 API 的邊界在哪在「用戶說(shuō)不清參數(shù)」的那一刻。「浙江一帶做注塑模具、最好有出口經(jīng)驗(yàn)的廠」——這句話里有地域還是模糊地域、有品類(lèi)、有一個(gè)很難落成字段的條件。傳統(tǒng)做法是前端堆一堆篩選器逼用戶自己翻譯另一條路是把翻譯這件事交給服務(wù)端的 AI。這篇拆一個(gè)走后一條路的實(shí)際接口天下工廠開(kāi)放平臺(tái)的factory_agent_search。背景一句話天下工廠是覆蓋全國(guó) 480 萬(wàn)家工廠的數(shù)據(jù)庫(kù)收錄前做了工廠身份識(shí)別真實(shí)從事生產(chǎn)的工廠才進(jìn)庫(kù)貿(mào)易商與空殼類(lèi)主體排除開(kāi)放平臺(tái)以 MCP 與 REST 雙通道提供能力文檔在 https://www.tianxiagongchang.com/open/docs。接口形狀REST 調(diào)用curl-shttps://open.tianxiagongchang.com/open/v1/capabilities/factory_agent_search\-HAuthorization: Bearer$TIANXIA_API_KEY\-HContent-Type: application/json\-d{query:浙江一帶做注塑模具、有出口經(jīng)驗(yàn)的廠}入?yún)⒕蛢蓚€(gè)字段query必填一句話中文效果最好和conversation_id選填下文細(xì)說(shuō)。沒(méi)有別的參數(shù)——這個(gè)接口的全部設(shè)計(jì)哲學(xué)就是「把翻譯工作收進(jìn)服務(wù)端」。返回是一份經(jīng)過(guò)核實(shí)的工廠名單外加本輪的conversation_id。單次執(zhí)行 30 到 90 秒服務(wù)端的代理要解析意圖、規(guī)劃篩選、執(zhí)行檢索、對(duì)候選做核實(shí)這個(gè)耗時(shí)是真實(shí)工作量不是網(wǎng)絡(luò)慢?？蛻舳顺瑫r(shí)要設(shè)到 180 秒以上默認(rèn) 10 秒超時(shí)會(huì)把正常執(zhí)行掐斷。conversation_id多輪收窄這是這個(gè)接口最值得說(shuō)的設(shè)計(jì)。第一輪拿到名單后把響應(yīng)里的conversation_id帶上再發(fā)第二句{query:只要成立十年以上、規(guī)模大一點(diǎn)的,conversation_id:上一輪返回的值}代理會(huì)在上一輪的語(yǔ)境里理解這句話——「成立十年以上」疊加到已有條件上而不是從頭開(kāi)始一次新檢索。對(duì)話式收窄的體驗(yàn)就出來(lái)了先粗后細(xì)兩三輪把名單磨到能用。對(duì)開(kāi)發(fā)者來(lái)說(shuō)這意味著你可以在自己的產(chǎn)品里用極小的前端成本實(shí)現(xiàn)「對(duì)話式選供應(yīng)商」一個(gè)輸入框一個(gè)列表conversation_id存在會(huì)話狀態(tài)里沒(méi)了。篩選器、級(jí)聯(lián)下拉、行業(yè)樹(shù)選擇器全都不用做。和結(jié)構(gòu)化檢索怎么分工平臺(tái)同時(shí)提供factory_search關(guān)鍵詞 省市區(qū)縣 行業(yè)碼的結(jié)構(gòu)化檢索。兩者的分工判據(jù)很簡(jiǎn)單條件能寫(xiě)成參數(shù)用factory_search?？炱胀ㄏ蘖髅糠昼?300 次便宜結(jié)果可完全復(fù)現(xiàn)。條件還是一句話用factory_agent_search。慢與深挖能力共享每分鐘 6 次的慢速限流單價(jià)也不同但省掉了「把話翻譯成參數(shù)」的全部工程。一個(gè)務(wù)實(shí)的混合架構(gòu)是產(chǎn)品首頁(yè)給一句話入口走代理代理返回的名單頁(yè)上再給結(jié)構(gòu)化篩選器走factory_search微調(diào)——兩個(gè)接口入?yún)⒊鰠⒍荚谕惶捉y(tǒng)一響應(yīng)格式里items里的公司id通用混用沒(méi)有任何縫。試起來(lái)控制臺(tái)注冊(cè)即送體驗(yàn)額度https://www.tianxiagongchang.com/open/console。想先看看返回長(zhǎng)什么樣公開(kāi)沙箱密鑰sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a可以直接用返回示例數(shù)據(jù)不計(jì)費(fèi)。計(jì)費(fèi)按量單次以角計(jì)價(jià)每個(gè)響應(yīng)帶扣費(fèi)回執(zhí)?！缸匀徽Z(yǔ)言進(jìn)、核實(shí)過(guò)的名單出」這個(gè)形態(tài)我判斷會(huì)是數(shù)據(jù)類(lèi) API 的標(biāo)準(zhǔn)配置之一——畢竟調(diào)用方越來(lái)越多不是人是另一個(gè) Agent。而 Agent 之間傳一句話永遠(yuǎn)比傳二十個(gè)參數(shù)穩(wěn)。