Foresee

官方

Foresee 讓 AI 助手能夠比較所有保險公司和保障選項的房屋及汽車保險,提供即時、準確、詳細的報價估算。

你可以用 Foresee MCP 做什麼?

  • 比較房屋與汽車保險報價 — 透過 quote_insurance,在一次通話中即可向多家保險公司及多種保障選項索取即時、逐項的報價估算。

  • 取得保險公司即時確認 — 使用 live_carrier_quotes,在取得同意後,直接從保險公司官方網站請求即時報價驗證。

  • 以特定保額為汽車保險定價 — 指定體傷責任、財損責任及自負額(例如 bi、coll_deductible),即可查看每家保險公司逐項的每月費用。

  • 估算房屋或租屋保險保單 — 提供房產詳細資料與保障金額(例如 coverage_a、deductible),即可取得房屋結構、責任險及個人財產的定價。

  • 找出影響價格的遺漏資訊 — 詢問哪些未填寫的個人資料欄位(例如 annual_mileage、prior_insurance)對報價影響最大,可透過回應中的 tighten_by 與 assumptions 取得。

託管 MCP 伺服器

npx add-mcp 'https://agents.go-foresee.com/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

文件

給 AI 代理:網站索引位於 /llms.txt,全文位於 /llms-full.txt。

Foresee 讓 AI 助手能夠比較所有保險公司和承保選項的房屋與汽車保險,提供即時、準確、詳細的報價估算。

使用 Foresee

Foresee 託管兩個 MCP 伺服器:

想要在不提供個人識別資訊(PII)的情況下獲得簡單、低門檻報價估算的使用者,請使用:

https://mcp.go-foresee.com/mcp

想要直接與保險公司確認報價估算的使用者,可以透過以下方式派遣 Foresee 的電腦使用代理:

https://agents.go-foresee.com/mcp

兩個伺服器都不需要驗證。

工具

Foresee 在 MCP 伺服器上發布兩個工具:

工具用途agents.mcp.
quote_insurance產生即時、準確、詳細的報價估算✅✅
live_carrier_quotes與保險公司確認報價估算✅❌

工具 1:quote_insurance

用途:在一次呼叫中,從 Foresee 支援的保險公司,針對 Foresee 目前服務的險種和州別,產生即時、逐項列出的報價估算。

輸入參數

參數類型必填詳細說明
profileobject是請參閱「個人資料」
linesobject是鍵是欲定價的險種(auto、home、renters);值是該險種的承保選項(請參閱「承保選項」)
carriersstring[]否預設為「所有保險公司」
include_failuresboolean否true

個人資料

核心個人資料

有一個核心輸入 profile,加上汽車和房屋/租戶保險的額外區塊。 唯一必填欄位是年齡(或 dob)、郵遞區號,以及(汽車保險的)車輛詳細資料。

省略的選填欄位會變成已聲明的假設:我們會選擇一個保守的替代值,並回報為 assumptions——例如 auto.vehicles[].annual_mileage = 12000,並附上 tighten_by 條目,列出最能影響價格的假設。prior_insurance 表示同一險種的保險;companion_policies 表示不同險種的保險。

欄位類型必填
zip_codestring是
ageinteger是
dobstring, YYYY-MM-DD可接受的 age 替代方案
citystring否
genderstring否
marital_statusstring否
educationstring否
employment_statusstring否
occupationstring否
credit_rangestring否
home_ownership_statusstring否
residence_typestring否
military_affiliationstring否
membershipsstring[]否
effective_datestring否
prior_insuranceobject否
companion_policiesobject[] — {line, carrier}否

companion_policies 列出家庭已持有的保單,每份保單附有承保的保險公司——{"line": "home", "carrier": "State Farm"}。保險公司的多重保單折扣僅適用於其承保的保單,因此沒有保險公司的持有保單無法獲得折扣,報價會在 tighten_by 下詢問保險公司。

汽車保險個人資料

欄位類型必填
auto.vehicles[].yearinteger是
auto.vehicles[].makestring是
auto.vehicles[].modelstring是
auto.vehicles[].ownershipstring否
auto.vehicles[].annual_mileageinteger否
auto.vehicles[].primary_usestring否
auto.vehicles[].garaging_zipstring否
auto.drivers[].relationstring否(第一個為 self)
auto.drivers[].dobstring否
auto.drivers[].years_licensedinteger否
auto.drivers[].accidentsobject[]否
auto.drivers[].violationsobject[]否
auto.drivers[].sr22_requiredboolean否

accidents 和 violations 是帶有日期的條目清單——{"on": "2025-01", "kind": "speeding"}、{"on": "2023-06-15", "at_fault": true}——其中空清單代表紀錄良好。缺少 on 的條目(或缺少 kind 的違規)會被拒絕,並指出其路徑。

房屋與租戶保險個人資料

欄位類型必填
property.year_builtinteger否
property.construction_typestring否
property.roof_typestring否
property.square_feetinteger否
property.protection_classstring否
property.replacement_costinteger否
property.devicesstring[]否
property.lossesobject[]否

承保選項

lines 中的每個鍵接受該險種的承保選項。沒有任何項目以伺服器預設值定價:您傳遞的選項就是被定價的選項。

汽車

選項類型必填承保範圍
bistring是身體傷害責任險:您對他人造成的傷害。每人/每次事故限額(以千美元計),例如 "100/300"
pdinteger是財產損失責任險:您對他人車輛和財產造成的損害。限額(以千美元計),例如 100
coll_deductibleinteger是碰撞險:因碰撞對您自己的汽車造成的損害,無論責任歸屬。您每次索賠支付的自負額(美元)
comp_deductibleinteger是綜合險:因碰撞以外原因(竊盜、火災、冰雹、惡意破壞、撞到動物)對您自己的汽車造成的損害。您每次索賠支付的自負額(美元)
umstring否未投保/不足額投保駕駛人險:當有過失的駕駛人沒有或只有不足的保險時,您的傷害。每人/每次事故限額(以千美元計),例如 "100/300"
medpayinteger否醫療給付險:您和乘客的醫療費用,無論責任歸屬。限額(美元),例如 5000

房屋

選項類型必填承保範圍
coverage_ainteger是dwelling:重建房屋本身。限額(美元),通常是重置成本
coverage_einteger是個人責任險:您在物業內外依法應負責的傷害或損害。限額(美元)
coverage_finteger是對他人的醫療給付:訪客在您的物業受傷後的醫療費用,無論責任歸屬。限額(美元)
aop_deductibleinteger是其他一切風險自負額:除自有自負額的風險(如地震)外,您每次索賠支付的金額(美元)

承保範圍 B(其他建築物,如獨立車庫或圍籬)、C(個人財產——您的物品)和 D(使用損失——房屋無法居住時的生活費用)不以美元詢問——它們會在 sel 中以已定價的承保範圍 A 之比率回報。

租戶

選項類型必填承保範圍
coverage_cinteger是個人財產:您的物品。限額(美元)
coverage_einteger是個人責任險:您依法應負責的傷害或損害。限額(美元)
coverage_finteger是對他人的醫療給付:訪客在您家中受傷後的醫療費用,無論責任歸屬。限額(美元)
deductibleinteger是承保開始前您每次索賠支付的金額(美元)
coverage_dinteger否使用損失:若您在房屋修繕期間必須搬出,額外的生活費用。限額(美元)

回應格式

定價結果完全在 structuredContent 中回傳;content 為空。評級詳細資料是 dense 欄位:緊湊的機器文字,每行一個區段,顯示在下面的 response 區塊中。旁邊是每個險種的標題欄位,位於 by_line 下(具有 monthly、confidence_interval、carrier_quote_url、warnings、rated_vs_asked 的保險公司;加上 assumptions、tighten_by、failures),以及頂部的 presentation(如何呈現價格)、bundle 和 skipped。拒絕(profile_required、coverage_required)是純 JSON,沒有 dense。

前綴頻率含義
Q每行一次被定價的內容:州別、險種、承保選擇
assumptions:每行一次Foresee 所做的假設;high_impact: true 表示此欄位會大幅影響報價估算
tighten_by:每行一次最能影響價格的缺失事實之個人資料路徑
not_priced:適用時被排除的保險公司及原因
C每家保險公司一次保險公司、承保實體、每月保費(點估計和信賴區間)
W視需要上述保險公司的備註,例如沒有線上報價頁面
L每家保險公司一次每月每項承保的成本,使用在每家保險公司代表相同承保範圍的代碼(BI、PD、UMBI、MEDPAY、COMP、COLL…);A+B 是涵蓋兩者的單一保費,FEE 是固定費用
D每家保險公司價格階梯:對於每個承保槓桿,每個提供的級距以相對於報價月費的 ±$/月 表示,其他所有條件維持在選擇值。+0.00 標記所選級距;(asked X) = X 未提供,價格位於最接近的提供級距。從 D 重新定價;不要重新呼叫

範例:汽車

一位 41 歲、郵遞區號 90066、擁有 2021 年 Honda Civic 的使用者。

Mercury 顯示單純的保險公司儲存格;Travelers 透過兩個可能的承保實體報價,因此其儲存格帶有 ci 區段(配置跨度)。USAA 落在 not_priced,並附有保險公司自己的原因。

{
  "profile": {
    "zip_code": "90066",
    "age": 41,
    "auto": {"vehicles": [{"year": 2021, "make": "Honda", "model": "Civic"}]}
  },
  "lines": {"auto": {"bi": "100/300", "pd": 100, "coll_deductible": 500, "comp_deductible": 500}},
  "carriers": ["mercury", "travelers", "usaa"]
}

每個省略的個人資料欄位都會回報為已聲明的假設——下面粗體的 assumptions: 區塊是由上方精簡的請求造成的,而 tighten_by: 列出最能影響價格的九個答案。Mercury 顯示單純的保險公司儲存格;Travelers 透過兩個可能的承保實體報價,因此其儲存格帶有 ci 區段(配置跨度)。USAA 落在 not_priced,並附有保險公司自己的原因。

Q CA auto sel={"bi":"100/300","coll_deductible":500,"comp_deductible":500,"pd":100}
assumptions: [{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":12000,"field":"auto.vehicles[].annual_mileage","high_impact":true},{"assumed":"Commute","field":"auto.vehicles[].primary_use","high_impact":true},{"assumed":15,"field":"auto.vehicles[].one_way_miles","high_impact":true},{"assumed":5,"field":"auto.vehicles[].commute_days","high_impact":false},{"assumed":16,"field":"auto.drivers[].age_first_licensed","high_impact":true,"note":"CA Good Driver discount (at least 20% off every CA price here, INS §1861.025) is granted on this assumption: it rates the applicant as licensed 3+ years. If they were first licensed less than 3 years ago, these prices are understated — send auto.drivers[].age_first_licensed (or date_first_licensed / years_licensed on the same driver) and re-quote."},{"assumed":[],"field":"auto.drivers[].accidents","high_impact":true},{"assumed":[],"field":"auto.drivers[].violations","high_impact":true},{"assumed":false,"field":"prior_insurance.insured","high_impact":true},{"assumed":null,"field":"home_ownership_status","high_impact":false},{"assumed":null,"field":"occupation","high_impact":true},{"assumed":null,"field":"memberships","high_impact":true}]
tighten_by: auto.vehicles[].annual_mileage,auto.vehicles[].primary_use,auto.vehicles[].one_way_miles,auto.drivers[].age_first_licensed,auto.drivers[].accidents,auto.drivers[].violations,prior_insurance.insured,occupation,memberships
not_priced: usaa:USAA: military families only — set military_affiliation to quote.
C mercury|Mercury Insurance Company|235.11
L BI:56.33,PD:44.10,UMBI:16.85,MEDPAY:0.97,COMP:17.49,COLL:99.38
D bi 100/300=30/60:-9.70,50/100:-6.72,100/300:+0.00,250/500:+12.31,300/300:+12.68,500/500:+23.13
D pd 100=15:-7.99,25:-6.39,50:-2.88,100:+0.00,250:+2.56,300:+3.83
D coll_deductible 500=100:+19.87,200:+14.91,250:+12.42,500:+0.00,1000:-9.94,2000:-29.81,2500:-39.75
D comp_deductible 500=25:+25.74,50:+17.88,100:+11.00,200:+6.09,250:+2.75,500:+0.00,1000:-2.75,2000:-5.70,2500:-8.06
C travelers|Travelers Commercial Insurance Company|368.50|ci 327.21-415.00
L BI:149.00,PD:70.17,COMP:15.50,COLL:114.33,UMBI:19.50
D bi 100/300=15/30:-61.67,25/50:-39.33,30/60:-32.83,50/100:-13.50,100/300:+0.00,250/500:+12.50,500/500:+16.67,1000/1000:+52.67
D pd 100=5:-21.50,10:-10.50,15:-6.67,25:-2.83,50:-0.67,100:+0.00,250:+0.50,300:+0.83,500:+1.17
D coll_deductible 500=100:+22.17,250:+13.17,500:+0.00,1000:-19.33,1500:-34.50,2500:-56.50,5000:-86.00
D comp_deductible 500=0:+11.17,50:+9.67,100:+8.00,250:+2.17,500:+0.00,1000:-1.67,1500:-3.67,2500:-6.50,5000:-10.50

範例:房屋

同一位 41 歲使用者,為一棟建於 1998 年、重置成本為 450,000 美元的框架房屋投保:

{
  "profile": {
    "zip_code": "90066",
    "age": 41,
    "property": {"year_built": 1998, "construction_type": "frame", "replacement_cost": 450000}
  },
  "lines": {"home": {"coverage_a": 450000, "coverage_e": 300000, "coverage_f": 1000, "aop_deductible": 1000}},
  "carriers": ["mercury", "autoclub"]
}

sel 將 B/C/D 回報為已定價的承保範圍 A 之比率。每家保險公司的 L 是其基本保費(HO_BASE)加上費用。房屋事實位於 assumptions:/tighten_by:——這裡是屋頂類型、保護等級和乾淨的損失紀錄。

Q CA home sel={"aop_deductible":1000,"coverage_a":450000,"coverage_b_pct":0.1,"coverage_c_pct":0.5,"coverage_d_pct":0.2,"coverage_e":300000,"coverage_f":1000}
assumptions: [{"assumed":"Asphalt Shingle","field":"property.roof_type","high_impact":false},{"assumed":1,"field":"property.stories","high_impact":false},{"assumed":2,"field":"property.bathrooms","high_impact":false},{"assumed":1,"field":"property.units","high_impact":false},{"assumed":"owner occupied","field":"property.occupancy","high_impact":false},{"assumed":5,"field":"property.protection_class","high_impact":true},{"assumed":"Attached","field":"property.garage","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"property.losses","high_impact":true}]
tighten_by: property.protection_class,property.losses
C mercury|CALIFORNIA AUTOMOBILE INS CO|123.67
L HO_BASE:118.76,FEE:3.75,FEE:1.16,FEE:0.01
D aop_deductible 1000=500:+13.38,1000:+0.00,1500:-5.38,2500:-21.45,3500:-26.58,5000:-37.01,10000:-48.28,25000:-63.01,50000:-72.51
D coverage_a 450000=30000:-90.60,65000:-82.94,95000:-76.38,130000:-68.81,165000:-61.24,195000:-54.76,230000:-47.27,265000:-39.79,295000:-33.39,330000:-25.82,365000:-18.34,395000:-11.94,430000:-4.37,445000:-1.17,450000:+0.00,455000:+1.01,465000:+3.20,500000:+10.86,570000:+26.34,630000:+39.88,700000:+56.03,770000:+72.77,830000:+87.49,900000:+105.41,970000:+124.09,2500000:+523.01,6000000:+1464.79
D coverage_e 300000=100000:-1.34,200000:-0.58,300000:+0.00,500000:+0.68,1000000:+4.04
D coverage_f 1000=1000:+0.00,2000:+0.17,5000:+0.42
C autoclub|Interinsurance Exchange of the Automobile Club|146.10
L HO_BASE:144.50,FEE:1.60
D aop_deductible 1000=500:+20.98,750:+7.59,1000:+0.00,1500:-11.45,2000:-16.93,3000:-21.06,5000:-25.36,10000:-28.73,15000:-51.90,20000:-63.44,25000:-71.53,30000:-77.34,50000:-90.49
D coverage_a 450000=60000:-120.65,90000:-115.51,110000:-110.96,130000:-105.66,150000:-99.59,170000:-92.85,190000:-86.53,220000:-76.17,250000:-64.54,280000:-54.09,320000:-40.02,350000:-29.15,360000:-26.54,400000:-16.00,440000:-3.62,450000:+0.00,460000:+2.45,480000:+9.44,550000:+32.95,650000:+77.19,750000:+98.00,850000:+116.62,950000:+147.71,2000000:+475.47,4000000:+1099.41,10000000:+2982.24

範例:租戶

同一個郵遞區號的不同家庭:一位 27 歲的租戶:

{
  "profile": {"zip_code": "90066", "dob": "1998-11-11"},
  "lines": {"renters": {"coverage_c": 30000, "coverage_e": 100000, "coverage_f": 1000, "deductible": 500}},
  "carriers": ["farmers", "usaa"]
}
Q CA renters sel={"coverage_c":30000,"coverage_e":100000,"coverage_f":1000,"deductible":500}
assumptions: [{"assumed":2000,"field":"property.year_built","high_impact":false},{"assumed":5,"field":"property.protection_class","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"property.losses","high_impact":true}]
tighten_by: property.losses
not_priced: usaa:USAA: military families only — set military_affiliation to quote.
C farmers|Fire Insurance Exchange|29.88
L RENTERS_BASE:29.17,FEE:0.42,FEE:0.30
D deductible 500=100:+5.89,250:+1.85,500:+0.00,1000:-2.61,1500:-4.29,2500:-6.73
D coverage_c 30000=4000:-16.33,10000:-11.95,17000:-7.15,23000:-3.87,29000:-0.59,30000:+0.00,31000:+0.51,37000:+3.79,43000:+7.07,49000:+10.36,55000:+13.64,62000:+17.43,68000:+20.71,74000:+23.99,81000:+27.78,87000:+31.06,93000:+34.35,100000:+38.14,106000:+41.42,112000:+44.70,118000:+47.99,125000:+51.77,131000:+55.06,137000:+58.34,144000:+62.13,150000:+65.41
D coverage_e 100000=100000:+0.00,300000:+3.28,500000:+5.56,1000000:+10.69

範例:汽車 + 租戶

同一位 27 歲租戶,現在有一輛車。空的 violations 和 accidents 清單代表紀錄良好,因此駕駛紀錄問題完全留下 assumptions:。

{
  "profile": {
    "zip_code": "90066",
    "age": 27,
    "prior_insurance": {"insured": true, "carrier": "GEICO", "since": "2019"},
    "auto": {"drivers": [{"violations": [], "accidents": []}],
             "vehicles": [{"year": 2021, "make": "Honda", "model": "Civic", "annual_mileage": 9000}]},
    "property": {"year_built": 1978, "square_feet": 850}
  },
  "lines": {
    "auto": {"bi": "100/300", "pd": 100, "coll_deductible": 500, "comp_deductible": 500},
    "renters": {"coverage_c": 30000, "coverage_e": 100000, "coverage_f": 1000, "deductible": 500}
  },
  "carriers": ["farmers", "mercury"]
}

既然我們現在提供了紀錄、里程和保險歷史,汽車的 assumptions: 縮減為八個條目,其 tighten_by: 縮減為五個。租戶區塊聲明了自己的 dwelling 替代值。Mercury 只為汽車定價;Farmers 為兩個險種定價。

Q CA auto sel={"bi":"100/300","coll_deductible":500,"comp_deductible":500,"pd":100}
assumptions: [{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":"Commute","field":"auto.vehicles[].primary_use","high_impact":true},{"assumed":15,"field":"auto.vehicles[].one_way_miles","high_impact":true},{"assumed":5,"field":"auto.vehicles[].commute_days","high_impact":false},{"assumed":16,"field":"auto.drivers[].age_first_licensed","high_impact":true,"note":"CA Good Driver discount (at least 20% off every CA price here, INS §1861.025) is granted on this assumption: it rates the applicant as licensed 3+ years. If they were first licensed less than 3 years ago, these prices are understated — send auto.drivers[].age_first_licensed (or date_first_licensed / years_licensed on the same driver) and re-quote."},{"assumed":null,"field":"home_ownership_status","high_impact":false},{"assumed":null,"field":"occupation","high_impact":true},{"assumed":null,"field":"memberships","high_impact":true}]
tighten_by: auto.vehicles[].primary_use,auto.vehicles[].one_way_miles,auto.drivers[].age_first_licensed,occupation,memberships
C mercury|Mercury Insurance Company|289.94
L BI:66.80,PD:52.55,UMBI:17.38,MEDPAY:1.05,COMP:23.50,COLL:128.67
D bi 100/300=30/60:-11.50,50/100:-7.96,100/300:+0.00,250/500:+14.60,300/300:+15.04,500/500:+27.43
D pd 100=15:-9.52,25:-7.61,50:-3.43,100:+0.00,250:+3.05,300:+4.57
D coll_deductible 500=100:+25.74,200:+19.30,250:+16.09,500:+0.00,1000:-12.87,2000:-38.60,2500:-51.47
D comp_deductible 500=25:+34.59,50:+24.03,100:+14.79,200:+8.19,250:+3.70,500:+0.00,1000:-3.70,2000:-7.66,2500:-10.83
C farmers|Farmers Insurance Exchange|398.00
L BI:111.83,PD:73.33,UMBI:28.33,UMPD:1.50,MEDPAY:13.33,COMP:34.00,COLL:133.17,FEE:2.50
D bi 100/300=30/60:-23.83,50/100:-14.67,100/300:+0.00,250/500:+9.83,500/500:+23.83,500/1000:+29.83
D pd 100=15:-8.83,25:-5.00,50:-1.50,100:+0.00,250:+1.33,500:+3.17
D coll_deductible 500=250:+30.67,500:+0.00,750:-13.67,1000:-23.50,1500:-37.50,2500:-56.33,5000:-87.00
D comp_deductible 500=100:+23.67,250:+9.17,500:+0.00,750:-7.17,1000:-10.67,1500:-13.50,2500:-18.83,5000:-21.17
Q CA renters sel={"coverage_c":30000,"coverage_e":100000,"coverage_f":1000,"deductible":500}
assumptions: [{"assumed":5,"field":"property.protection_class","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"property.losses","high_impact":true}]
tighten_by: property.losses
not_priced: mercury:no filed-rate renters program served in CA yet
C farmers|Fire Insurance Exchange|29.88
L RENTERS_BASE:29.17,FEE:0.42,FEE:0.30
D deductible 500=100:+5.89,250:+1.85,500:+0.00,1000:-2.61,1500:-4.29,2500:-6.73
D coverage_c 30000=4000:-16.33,10000:-11.95,17000:-7.15,23000:-3.87,29000:-0.59,30000:+0.00,31000:+0.51,37000:+3.79,43000:+7.07,49000:+10.36,55000:+13.64,62000:+17.43,68000:+20.71,74000:+23.99,81000:+27.78,87000:+31.06,93000:+34.35,100000:+38.14,106000:+41.42,112000:+44.70,118000:+47.99,125000:+51.77,131000:+55.06,137000:+58.34,144000:+62.13,150000:+65.41
D coverage_e 100000=100000:+0.00,300000:+3.28,500000:+5.56,1000000:+10.69

工具 2:live_carrier_quotes

用途:在保險公司自己的報價網站上確認報價估算。

此工具是冪等的:第一次呼叫派遣電腦使用代理;使用相同參數再次呼叫會收集第一次呼叫的進度和結果。

即時派遣會將使用者的真實詳細資料提交給保險公司,保險公司可能會進行軟性信用查詢。在呼叫工具之前會先取得使用者的同意。

Foresee 只收集報價;它不收款或綁定保險。

輸入參數

參數型別必填說明
profileobject是與 quote_insurance 相同的欄位 — 評分事實
linesobject是每個要執行的險種一個鍵,每個值為該險種的詢問內容(見下文);數個鍵同時觸發捆綁執行
user_authorizationstring是使用者在聊天中的確認語,逐字保留(例如 yes, go ahead)
identityobject通常使用者的詳細資料。
carriersstring[]否限制保險公司;預設為所有對該險種+州別有已驗證執行流程的保險公司

lines

險種詢問內容原因
auto必填 — 與 quote_insurance 相同的四個軸向(bi、pd、coll_deductible、comp_deductible),以實際數字呈現保險公司表單要求代理人填寫的限額與自付額
home無 — {"home": null}保險公司自己的表單會為其保單定價( dwelling 金額來自其重置成本估算);代理人回報其選擇。若提供詢問內容會被大聲拒絕,而非靜默忽略
renters必填 — coverage_c、coverage_e、coverage_f、deductible,以實際美元金額呈現代理人在表單上輸入使用者的數字,而非接受預設值;Foresee 絕不自行發明

同時提供數個鍵會觸發捆綁執行:每個承保所有指定險種的保險公司都會被引導完成其多險種報價流程,並回報各險種保費及其自身的捆綁總額;僅承保部分險種的保險公司則只針對那些險種執行。各險種的詢問規則不因捆綁而改變。

identity

欄位型別必填說明
first_namestring是法定名字
last_namestring是法定姓氏
dobstring, YYYY-MM-DD是
streetstring是街道地址(第一行)
unitstring否公寓/單位(第二行)
citystring是
zip_codestring否僅當與個人資料中的不同時
emailstring是保險公司將報價寄至此處
phonestring否

回應

欄位意義
statusin_progress / partial / complete — 以相同參數重新呼叫以收集結果
agents每家保險公司一個條目(見下文)
note下一步動作,例如重新呼叫的時機,或先前執行的結果已回傳
authorization_recorded在收據上:同意紀錄在任何保險公司看到風險之前已儲存
skipped未派送的保險公司,各自附上原因(no_deterministic_walk、missing_facts 並指名事實)
not_dispatched本次派送不會執行的引擎定價保險公司及其原因(held: …、no_walk、not_walked、offline、not_sold)— 執行通道無法確認的建議絕不會靜默消失
needs在 missing_facts 拒絕時:需向使用者收集的各保險公司事實,附上確切的 schema 路徑 — 以及對於封閉詞彙欄位,接受的 values
assumptions執行流程解析為已聲明無索賠答案的未斷言次要表單事實:個人資料路徑(field)與提交的值(assumed)— 將每一項與結果一起轉達
error / detail每次拒絕都是一個結構化的 {"error", "detail"} 字典

每個 agents 條目:

欄位時機意義
carrier_key、carrier永遠名冊鍵+顯示名稱
status永遠in_progress / complete / failed
lines永遠此執行涵蓋的險種 — 捆綁執行時為多個
stage、eta_seconds_remaining進行中執行目前位置;相對於該保險公司典型流程的剩餘時間
quote.premium已報價逐字保留保險公司頁面列印的內容("$857.80")— 絕不解析、四捨五入或衍生
quote.term_months已報價列印保費所涵蓋的期間
quote.premium_by_line已報價、捆綁執行頁面列印的各險種保費,與 quote.premium 中的捆綁總額並列
quote.breakdown已報價頁面自身的明細項目、其自身的標籤
quote.bound已報價、較新執行從定價頁面讀取的保障內容 — 表單實際綁定的內容,對比所詢問的內容
quote.variants已報價頁面提供的其他定價保單方案
quote.quote_number已報價保險公司的取回編號,當頁面顯示時
quote.evidence_recorded已報價伺服器端存在截圖證據(內部 URI 絕不經由網路傳輸)
declined: true + detail已婉拒保險公司審閱詳細資料後拒絕報價。這是一個答案,而非錯誤 — 請轉達
detail失敗執行流程自身對停止位置與原因的說明

拒絕

每次拒絕都是一個結構化的 {"error", "detail"} 物件 — 除非下方表格另有說明,否則不會向任何保險公司提交任何內容。

代碼時機處理方式
profile_required家庭事實放在頂層傳送,沒有 profile 包裝以拒絕訊息中 example_arguments 所示的包裝方式重新呼叫
authorization_required未取得使用者同意即呼叫說明同意事實,取得肯定回覆,在 user_authorization 中逐字傳入
bad_identitydrivers_license_number 的形狀像 SSN絕不收集 SSN;請傳送駕照上列印的駕照號碼
bad_profile個人資料欄位驗證失敗detail 指名該欄位
one_line_per_dispatch空的 lines 對應至少指定一個要執行的險種
unknown_line某險種沒有執行流程(例如 umbrella)detail 列出即時派送已知的險種
coverage_selection_required汽車或租戶險執行缺少完整的限額與自付額以數字重新呼叫 — 執行流程輸入實際值,絕不使用預設值
bad_ask房屋險執行被給予保障詢問內容傳送 {"home": null} — 保險公司自己的表單會為其保單定價
missing_facts無法從個人資料填寫任何所要求保險公司的表單向使用者詢問 needs[].fields[] 事實(在提供時使用其 values)並重新呼叫 — 見下文
no_carriers沒有保險公司對該險種+州別有已驗證的執行流程退回至 quote_insurance
launch_failed代理人無法啟動未觸及任何保險公司 — 重試是安全的

範例:汽車險

Fresno 的一個家庭確認 GEICO 自己的數字。個人資料包含 GEICO 表單要求的 事實(所有權、購買時機、先前的保險、首次取得駕照年齡…);identity 是真實的申請人;詢問內容是與 quote_insurance 相同的四個軸向。

{
  "profile": {
    "zip_code": "93722",
    "dob": "1954-07-02",
    "gender": "Male",
    "marital_status": "Married",
    "education": "Bachelors",
    "employment_status": "Employed",
    "occupation": "Accountant or CPA",
    "home_ownership_status": "Own",
    "prior_insurance": {"insured": true, "limits": "not sure"},
    "auto": {
      "vehicles": [{
        "year": 2024, "make": "Ford", "model": "Maverick",
        "ownership": "Financed", "annual_mileage": 11000,
        "primary_use": "pleasure", "purchase_date": "2026-08"
      }],
      "drivers": [{
        "relation": "self", "age_first_licensed": 16,
        "years_licensed_outside_us": 0, "defensive_driving_course": true,
        "accidents": [], "violations": []
      }]
    }
  },
  "identity": {
    "first_name": "Cornelius", "last_name": "Beaumont", "dob": "1954-07-02",
    "street": "4381 W Spruce Ave", "city": "Fresno", "zip_code": "93722",
    "email": "cornelius.beaumont@example.com", "phone": "559-555-0164"
  },
  "lines": {"auto": {"bi": "100/300", "pd": 100, "coll_deductible": 500, "comp_deductible": 500}},
  "carriers": ["geico"],
  "user_authorization": "yes, go ahead and get me GEICO's real quote"
}
{
  "status": "in_progress",
  "authorization_recorded": true,
  "agents": [
    {
      "carrier_key": "geico",
      "carrier": "GEICO",
      "method": "browser_agent",
      "detail": "deterministic Foresee agent completing the carrier's own quote flow with the user's details",
      "eta_seconds": 480
    }
  ],
  "skipped": [],
  "note": "1 carrier(s) are being quoted live. Collect results by calling this tool again with the same arguments after a few minutes."
}

稍後以相同參數重新呼叫會收集完成的執行結果。 保費是頁面自身的字串;breakdown 是頁面自身的標籤 (GEICO 並排列印了兩個方案);term_months 說明該數字涵蓋的內容 — $857.80 每 6 個月,而非每月。

{
  "status": "complete",
  "agents": [
    {
      "carrier_key": "geico",
      "carrier": "GEICO",
      "method": "browser_agent",
      "status": "complete",
      "quote": {
        "premium": "$857.80",
        "currency": "USD",
        "term_months": 6,
        "quote_number": null,
        "breakdown": {
          "Less Coverage": "$857.80",
          "More Coverage": "$870.70"
        },
        "evidence_recorded": true
      }
    }
  ]
}