Foresee

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

Tài liệu

Dành cho các tác nhân AI: chỉ mục trang web nằm tại /llms.txt và toàn văn nằm tại /llms-full.txt.

Foresee cho phép các trợ lý AI so sánh bảo hiểm nhà và ô tô trên mọi hãng bảo hiểm và mọi lựa chọn phạm vi bảo hiểm, bằng cách cung cấp các ước tính báo giá chi tiết, chính xác và tức thì.

Sử dụng Foresee

Foresee lưu trữ hai máy chủ MCP:

Người dùng muốn có ước tính báo giá đơn giản, ít rào cản mà không phải cung cấp thông tin nhận dạng cá nhân (PII) sử dụng:

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

Người dùng cũng muốn xác nhận trực tiếp ước tính báo giá với các hãng bảo hiểm có thể điều phối các tác nhân sử dụng máy tính của Foresee thông qua:

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

Cả hai máy chủ đều không yêu cầu xác thực.

Công cụ

Foresee công bố hai công cụ trên các máy chủ MCP:

Công cụ	Mục đích	agents.	mcp.
quote_insurance	Tạo ước tính báo giá chi tiết, chính xác, tức thì	✅	✅
live_carrier_quotes	Xác nhận ước tính báo giá với các hãng bảo hiểm	✅	❌

Công cụ 1: quote_insurance

Mục đích: tạo ước tính báo giá chi tiết, tức thì từ các hãng bảo hiểm mà Foresee hỗ trợ, trên các dòng bảo hiểm và tiểu bang mà Foresee hiện đang phục vụ, chỉ trong một lần gọi.

Tham số đầu vào

Tham số	Loại	Bắt buộc	Chi tiết
profile	object	có	xem Hồ sơ
lines	object	có	Các khóa là các dòng bảo hiểm cần định giá (auto, home, renters); giá trị là các tùy chọn phạm vi bảo hiểm của dòng đó (xem Tùy chọn phạm vi bảo hiểm)
carriers	string[]	không	Mặc định là "tất cả các hãng bảo hiểm"
include_failures	boolean	không	true

Hồ sơ

Hồ sơ cốt lõi

Có một đầu vào cốt lõi profile, cộng với các khối bổ sung cho bảo hiểm ô tô và bảo hiểm nhà/người thuê nhà. Các trường bắt buộc duy nhất là độ tuổi (hoặc dob), mã ZIP và (đối với bảo hiểm ô tô) thông tin chi tiết về xe.

Các trường tùy chọn bị bỏ qua sẽ trở thành các giả định được khai báo: chúng tôi chọn một giá trị thay thế thận trọng, được báo cáo lại dưới dạng assumptions — ví dụ: auto.vehicles[].annual_mileage = 12000, kèm theo một mục tighten_by liệt kê các giả định có thể làm thay đổi giá nhiều nhất. prior_insurance có nghĩa là bảo hiểm cho cùng một dòng; companion_policies có nghĩa là bảo hiểm cho một dòng khác.

Trường	Loại	Bắt buộc
zip_code	string	có
age	integer	có
dob	string, YYYY-MM-DD	phương án thay thế được chấp nhận cho age
city	string	không
gender	string	không
marital_status	string	không
education	string	không
employment_status	string	không
occupation	string	không
credit_range	string	không
home_ownership_status	string	không
residence_type	string	không
military_affiliation	string	không
memberships	string[]	không
effective_date	string	không
prior_insurance	object	không
companion_policies	object[] — {line, carrier}	không

companion_policies liệt kê các hợp đồng bảo hiểm mà hộ gia đình đã nắm giữ, mỗi hợp đồng kèm theo hãng bảo hiểm phát hành — {"line": "home", "carrier": "State Farm"}. Chiết khấu đa hợp đồng của một hãng chỉ áp dụng cho hợp đồng do hãng đó phát hành, vì vậy một hợp đồng đang nắm giữ không có hãng bảo hiểm sẽ không được hưởng chiết khấu nào, và báo giá sẽ yêu cầu thông tin hãng bảo hiểm trong mục tighten_by.

Hồ sơ bảo hiểm ô tô

Trường	Loại	Bắt buộc
auto.vehicles[].year	integer	có
auto.vehicles[].make	string	có
auto.vehicles[].model	string	có
auto.vehicles[].ownership	string	không
auto.vehicles[].annual_mileage	integer	không
auto.vehicles[].primary_use	string	không
auto.vehicles[].garaging_zip	string	không
auto.drivers[].relation	string	không (self cho chiếc đầu tiên)
auto.drivers[].dob	string	không
auto.drivers[].years_licensed	integer	không
auto.drivers[].accidents	object[]	không
auto.drivers[].violations	object[]	không
auto.drivers[].sr22_required	boolean	không

accidents và violations là danh sách các mục có ngày tháng — {"on": "2025-01", "kind": "speeding"}, {"on": "2023-06-15", "at_fault": true} — trong đó danh sách trống nghĩa là hồ sơ sạch. Một mục thiếu on (hoặc một vi phạm thiếu kind) sẽ bị từ chối, kèm theo đường dẫn của mục đó.

Hồ sơ bảo hiểm nhà & người thuê nhà

Trường	Loại	Bắt buộc
property.year_built	integer	không
property.construction_type	string	không
property.roof_type	string	không
property.square_feet	integer	không
property.protection_class	string	không
property.replacement_cost	integer	không
property.devices	string[]	không
property.losses	object[]	không

Tùy chọn phạm vi bảo hiểm

Mỗi khóa trong lines nhận các tùy chọn phạm vi bảo hiểm của dòng đó. Không có gì được định giá theo mặc định của máy chủ: các tùy chọn bạn truyền vào chính là những gì được định giá.

Ô tô

Tùy chọn	Loại	Bắt buộc	Phạm vi bảo hiểm
bi	string	có	Trách nhiệm thương tật thân thể: thương tích bạn gây ra cho người khác. Giới hạn trên mỗi người/mỗi vụ tai nạn tính bằng nghìn đô la, ví dụ: "100/300"
pd	integer	có	Trách nhiệm thiệt hại tài sản: thiệt hại bạn gây ra cho xe và tài sản của người khác. Giới hạn tính bằng nghìn đô la, ví dụ: 100
coll_deductible	integer	có	Va chạm: thiệt hại cho chính xe của bạn từ một vụ va chạm, bất kể lỗi thuộc về ai. Khoản khấu trừ bạn phải trả cho mỗi yêu cầu bồi thường, tính bằng đô la
comp_deductible	integer	có	Toàn diện: thiệt hại cho chính xe của bạn từ bất kỳ nguyên nhân nào khác ngoài va chạm — trộm cắp, hỏa hoạn, mưa đá, phá hoại, va phải động vật. Khoản khấu trừ bạn phải trả cho mỗi yêu cầu bồi thường, tính bằng đô la
um	string	không	Bảo hiểm cho người lái xe không bảo hiểm/bảo hiểm không đủ: thương tích của bạn khi người gây lỗi không có hoặc có quá ít bảo hiểm. Giới hạn trên mỗi người/mỗi vụ tai nạn tính bằng nghìn đô la, ví dụ: "100/300"
medpay	integer	không	Chi trả y tế: hóa đơn y tế cho bạn và hành khách của bạn, bất kể lỗi thuộc về ai. Giới hạn tính bằng đô la, ví dụ: 5000

Nhà

Tùy chọn	Loại	Bắt buộc	Phạm vi bảo hiểm
coverage_a	integer	có	Nhà ở: xây lại chính ngôi nhà. Giới hạn tính bằng đô la, thường là chi phí thay thế
coverage_e	integer	có	Trách nhiệm cá nhân: thương tích hoặc thiệt hại mà bạn phải chịu trách nhiệm pháp lý, trong hoặc ngoài khuôn viên. Giới hạn tính bằng đô la
coverage_f	integer	có	Chi trả y tế cho người khác: hóa đơn y tế của khách sau khi bị thương trong khuôn viên của bạn, bất kể lỗi thuộc về ai. Giới hạn tính bằng đô la
aop_deductible	integer	có	Khoản khấu trừ cho mọi rủi ro khác: số tiền bạn trả cho mỗi yêu cầu bồi thường cho mọi thứ trừ các rủi ro có khoản khấu trừ riêng (chẳng hạn như động đất). Tính bằng đô la

Phạm vi bảo hiểm B (các công trình khác, chẳng hạn như nhà để xe tách rời hoặc hàng rào), C (tài sản cá nhân — đồ đạc của bạn) và D (mất khả năng sử dụng — chi phí sinh hoạt khi ngôi nhà không thể ở được) không được yêu cầu bằng đô la — chúng được trả về trong sel dưới dạng tỷ lệ của Phạm vi bảo hiểm A đã được định giá.

Người thuê nhà

Tùy chọn	Loại	Bắt buộc	Phạm vi bảo hiểm
coverage_c	integer	có	Tài sản cá nhân: đồ đạc của bạn. Giới hạn tính bằng đô la
coverage_e	integer	có	Trách nhiệm cá nhân: thương tích hoặc thiệt hại mà bạn phải chịu trách nhiệm pháp lý. Giới hạn tính bằng đô la
coverage_f	integer	có	Chi trả y tế cho người khác: hóa đơn y tế của khách sau khi bị thương trong nhà của bạn, bất kể lỗi thuộc về ai. Giới hạn tính bằng đô la
deductible	integer	có	Số tiền bạn trả cho mỗi yêu cầu bồi thường trước khi phạm vi bảo hiểm bắt đầu. Tính bằng đô la
coverage_d	integer	không	Mất khả năng sử dụng: chi phí sinh hoạt phát sinh thêm nếu bạn phải chuyển ra ngoài trong khi nơi ở đang được sửa chữa. Giới hạn tính bằng đô la

Định dạng phản hồi

Một kết quả đã định giá được trả về hoàn toàn trong structuredContent; content trống. Chi tiết xếp hạng là trường dense: văn bản máy gọn gàng, một phần trên mỗi dòng, được hiển thị trong các khối response bên dưới. Bên cạnh đó là các trường tiêu đề cho từng dòng trong mục by_line (các hãng bảo hiểm có monthly, confidence_interval, carrier_quote_url, warnings, rated_vs_asked; cộng với assumptions, tighten_by, failures), và presentation (cách trình bày giá), bundle và skipped ở đầu. Các trường hợp từ chối (profile_required, coverage_required) là JSON thuần không có dense.

Tiền tố	Tần suất	Ý nghĩa
Q	một lần mỗi dòng	Những gì được định giá: tiểu bang, dòng bảo hiểm, lựa chọn phạm vi bảo hiểm
assumptions:	một lần mỗi dòng	Các giả định do Foresee đưa ra; high_impact: true có nghĩa là trường này ảnh hưởng đáng kể đến ước tính báo giá
tighten_by:	một lần mỗi dòng	Các đường dẫn hồ sơ của những thông tin còn thiếu có thể làm thay đổi giá nhiều nhất
not_priced:	khi áp dụng	Các hãng bảo hiểm bị loại trừ, kèm lý do
C	một lần mỗi hãng	Hãng bảo hiểm, đơn vị phát hành, phí bảo hiểm hàng tháng (ước tính điểm và khoảng tin cậy)
W	khi cần	Ghi chú về hãng bảo hiểm ở trên, ví dụ: không có trang báo giá trực tuyến
L	một lần mỗi hãng	Chi phí hàng tháng cho từng phạm vi bảo hiểm, theo các mã có cùng ý nghĩa phạm vi bảo hiểm tại mọi hãng (BI, PD, UMBI, MEDPAY, COMP, COLL…); A+B là một khoản phí bảo hiểm bao gồm cả hai, FEE là một khoản phí cố định
D	mỗi hãng	Thang giá: cho từng đòn bẩy phạm vi bảo hiểm, mọi mức được cung cấp dưới dạng ±$/tháng so với mức hàng tháng đã báo giá, mọi thứ khác giữ nguyên theo lựa chọn. +0.00 đánh dấu mức đã chọn; (asked X) = X không được cung cấp và giá nằm ở mức được cung cấp gần nhất. Định giá lại từ D; không gọi lại

---

Ví dụ: ô tô

Một người 41 tuổi tại mã ZIP 90066 với chiếc Honda Civic 2021.

Mercury hiển thị ô hãng bảo hiểm đơn giản; Travelers định giá qua hai đơn vị phát hành khả dĩ, vì vậy ô của hãng này mang một phân đoạn ci (khoảng vị trí). USAA nằm trong not_priced với lý do riêng của hãng.

{
  "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"]
}

Mọi trường hồ sơ bị bỏ qua đều được trả về dưới dạng giả định được khai báo — khối assumptions: lớn bên dưới là do yêu cầu mỏng ở trên gây ra, và tighten_by: liệt kê chín câu trả lời có thể làm thay đổi giá nhiều nhất. Mercury hiển thị ô hãng bảo hiểm đơn giản; Travelers định giá qua hai đơn vị phát hành khả dĩ, vì vậy ô của hãng này mang một phân đoạn ci (khoảng vị trí). USAA nằm trong not_priced với lý do riêng của hãng.

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

---

Ví dụ: nhà

Cùng người 41 tuổi như trên, bảo hiểm một ngôi nhà khung gỗ xây năm 1998 với chi phí thay thế là 450.000 đô la:

{
  "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 phản ánh B/C/D dưới dạng tỷ lệ của Phạm vi bảo hiểm A đã được định giá. L của mỗi hãng là phí bảo hiểm cơ bản (HO_BASE) cộng với các khoản phí. Thông tin về ngôi nhà nằm trong assumptions:/tighten_by: — ở đây là loại mái, hạng bảo vệ và lịch sử tổn thất sạch.

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

---

Ví dụ: người thuê nhà

Một hộ gia đình khác tại cùng mã ZIP: một người thuê nhà 27 tuổi:

{
  "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

---

Ví dụ: ô tô + người thuê nhà

Cùng người thuê nhà 27 tuổi đó, bây giờ có thêm một chiếc xe. Danh sách violations và accidents trống nghĩa là hồ sơ sạch, vì vậy các câu hỏi về lịch sử lái xe hoàn toàn không xuất hiện trong 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"]
}

Vì giờ chúng tôi cung cấp lịch sử, số dặm và lịch sử bảo hiểm, assumptions: của ô tô giảm xuống còn tám mục và tighten_by: của nó còn năm mục. Phần người thuê nhà khai báo các giá trị thay thế cho ngôi nhà của riêng mình. Mercury định giá chỉ riêng ô tô; Farmers định giá cả hai dòng.

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

---

Công cụ 2: live_carrier_quotes

Mục đích: xác nhận ước tính báo giá trên các trang báo giá của chính các hãng bảo hiểm.

Công cụ này có tính chất lũy đẳng: lần gọi đầu tiên điều phối các tác nhân sử dụng máy tính; gọi lại với cùng tham số sẽ thu thập tiến độ và kết quả từ lần gọi đầu tiên.

Một lần điều phối trực tiếp sẽ gửi thông tin thực tế của người dùng đến các hãng bảo hiểm, những hãng này có thể thực hiện kiểm tra tín dụng mềm. Sự đồng ý của người dùng được thu thập trước khi công cụ được gọi.

Foresee chỉ thu thập báo giá; không nhận thanh toán hoặc ràng buộc bảo hiểm.

Tham số đầu vào

Tham số	Kiểu	Bắt buộc	Chi tiết
profile	object	có	Các trường giống như quote_insurance — các dữ kiện đánh giá
lines	object	có	Một khóa cho mỗi dòng cần duyệt, mỗi giá trị là yêu cầu của dòng đó (xem bên dưới); nhiều khóa sẽ tạo các lượt duyệt gộp
user_authorization	string	có	Lời xác nhận trong cuộc trò chuyện của người dùng, nguyên văn (ví dụ: yes, go ahead)
identity	object	thường có	Chi tiết của người dùng.
carriers	string[]	không	Giới hạn phạm vi nhà cung cấp; mặc định là mọi nhà cung cấp có lượt duyệt đã xác thực cho các dòng + tiểu bang

lines

Dòng	Yêu cầu	Lý do
auto	bắt buộc — cùng bốn trục như quote_insurance (bi, pd, coll_deductible, comp_deductible), dưới dạng số thực	Các giới hạn và khoản khấu trừ mà đại lý hỏi trên biểu mẫu của nhà cung cấp
home	không có — {"home": null}	Biểu mẫu của chính nhà cung cấp định giá gói của mình (số tiền nhà ở từ ước tính chi phí thay thế); đại lý báo cáo những gì họ chọn. Yêu cầu được cung cấp sẽ bị từ chối rõ ràng, không âm thầm bỏ qua
renters	bắt buộc — coverage_c, coverage_e, coverage_f, deductible, dưới dạng đô la thực	Đại lý nhập số của người dùng vào biểu mẫu thay vì chấp nhận giá trị mặc định; Foresee không bao giờ tự bịa ra chúng

Nhiều khóa cùng lúc sẽ tạo các lượt duyệt gộp: mỗi nhà cung cấp viết tất cả các dòng được nêu tên sẽ được dẫn qua luồng báo giá đa dòng của riêng mình và báo cáo phí bảo hiểm từng dòng cộng với tổng gói của riêng họ; nhà cung cấp chỉ viết một số dòng sẽ được duyệt riêng cho các dòng đó. Quy tắc yêu cầu từng dòng không thay đổi khi gộp.

identity

Trường	Kiểu	Bắt buộc	Chi tiết
first_name	string	có	Tên hợp pháp
last_name	string	có	Họ hợp pháp
dob	string, YYYY-MM-DD	có
street	string	có	Địa chỉ đường phố (dòng 1)
unit	string	không	Căn hộ/đơn vị (dòng 2)
city	string	có
zip_code	string	không	Chỉ khi khác với hồ sơ
email	string	có	Nhà cung cấp gửi báo giá đến đây
phone	string	không

Phản hồi

Trường	Ý nghĩa
status	in_progress / partial / complete — gọi lại với cùng tham số để thu thập
agents	Một mục cho mỗi nhà cung cấp (xem bên dưới)
note	Việc cần làm tiếp theo, ví dụ: thời điểm gọi lại, hoặc rằng kết quả của lần chạy trước đã được trả về
authorization_recorded	Trên biên nhận: bản ghi đồng thuận đã được lưu trước khi bất kỳ nhà cung cấp nào thấy rủi ro
skipped	Các nhà cung cấp KHÔNG được điều phối, mỗi nhà cung cấp kèm lý do (no_deterministic_walk, missing_facts với các dữ kiện được nêu tên)
not_dispatched	Các nhà cung cấp định giá bằng công cụ mà lượt điều phối này sẽ không duyệt, kèm lý do (held: …, no_walk, not_walked, offline, not_sold) — một khuyến nghị mà luồng duyệt không thể xác nhận sẽ không bao giờ âm thầm biến mất
needs	Khi từ chối missing_facts: các dữ kiện từng nhà cung cấp cần thu thập từ người dùng, với đường dẫn lược đồ chính xác — và, cho các trường từ vựng đóng, các values được chấp nhận
assumptions	Các dữ kiện biểu mẫu phụ chưa được xác nhận mà các lượt duyệt đã giải quyết thành câu trả lời không yêu cầu đã khai báo: đường dẫn hồ sơ (field) và giá trị đã gửi (assumed) — chuyển tiếp từng cái cùng với kết quả
error / detail	Mọi từ chối là một dict {"error", "detail"} có cấu trúc

Mỗi mục agents:

Trường	Khi nào	Ý nghĩa
carrier_key, carrier	luôn luôn	Khóa danh sách + tên hiển thị
status	luôn luôn	in_progress / complete / failed
lines	luôn luôn	Các dòng lượt duyệt này bao phủ — nhiều dòng trên lượt duyệt gộp
stage, eta_seconds_remaining	đang tiến hành	Vị trí lượt duyệt; thời gian còn lại so với luồng điển hình của nhà cung cấp
quote.premium	đã báo giá	Nguyên văn như trang của nhà cung cấp đã in ("$857.80") — không bao giờ phân tích, làm tròn hoặc suy ra
quote.term_months	đã báo giá	Kỳ hạn mà phí bảo hiểm đã in bao phủ
quote.premium_by_line	đã báo giá, lượt duyệt gộp	Phí bảo hiểm từng dòng như trang đã in, bên cạnh tổng gói trong quote.premium
quote.breakdown	đã báo giá	Các khoản mục của chính trang, nhãn của chính trang
quote.bound	đã báo giá, lượt duyệt mới hơn	Phạm vi bảo hiểm đọc từ trang đã định giá — những gì biểu mẫu thực sự ràng buộc, so với những gì được yêu cầu
quote.variants	đã báo giá	Các gói đã định giá bổ sung mà trang đưa ra
quote.quote_number	đã báo giá	Số truy xuất của nhà cung cấp, khi trang hiển thị
quote.evidence_recorded	đã báo giá	Bằng chứng ảnh chụp màn hình tồn tại ở phía máy chủ (URI nội bộ không bao giờ truyền qua mạng)
declined: true + detail	đã từ chối	Nhà cung cấp đã xem xét chi tiết và từ chối báo giá. Một câu trả lời, không phải lỗi — hãy chuyển tiếp nó
detail	thất bại	Lời của chính lượt duyệt về nơi và lý do nó dừng lại

Từ chối

Mọi từ chối là một đối tượng {"error", "detail"} có cấu trúc — không có gì được gửi đến bất kỳ nhà cung cấp nào trừ khi hàng bên dưới nói khác.

Mã	Khi nào	Việc cần làm
profile_required	Dữ kiện hộ gia đình được gửi ở cấp cao nhất, không có trình bao bọc profile	Gọi lại với các dữ kiện được bao bọc như hiển thị trong example_arguments của từ chối
authorization_required	Được gọi mà không có sự đồng ý của người dùng	Giải thích các dữ kiện đồng thuận, nhận lời đồng ý, chuyển nguyên văn trong user_authorization
bad_identity	Một drivers_license_number có hình dạng như SSN	SSN không bao giờ được thu thập; gửi số giấy phép như in trên giấy phép
bad_profile	Một trường hồ sơ không vượt qua xác thực	detail nêu tên trường
one_line_per_dispatch	Một bản đồ lines trống	Nêu tên ít nhất một dòng cần duyệt
unknown_line	Một dòng không có lượt duyệt (ví dụ: umbrella)	detail liệt kê các dòng mà điều phối trực tiếp biết
coverage_selection_required	Một lượt duyệt ô tô hoặc người thuê nhà không có đầy đủ giới hạn và khoản khấu trừ	Gọi lại với các số — các lượt duyệt nhập giá trị thực, không bao giờ mặc định
bad_ask	Một lượt duyệt nhà ở được đưa ra yêu cầu phạm vi bảo hiểm	Gửi {"home": null} — biểu mẫu của chính nhà cung cấp định giá gói của mình
missing_facts	Không có biểu mẫu nào của nhà cung cấp được yêu cầu có thể điền từ hồ sơ	Hỏi người dùng các dữ kiện needs[].fields[] (sử dụng values của họ nơi được phục vụ) và gọi lại — xem bên dưới
no_carriers	Không có nhà cung cấp nào có lượt duyệt đã xác thực cho dòng + tiểu bang đó	Dự phòng sang quote_insurance
launch_failed	Các đại lý không thể bắt đầu	Không có gì đến được bất kỳ nhà cung cấp nào — thử lại là an toàn

---

Ví dụ: ô tô

Một hộ gia đình ở Fresno xác nhận số của chính GEICO. Hồ sơ mang các dữ kiện mà biểu mẫu của GEICO yêu cầu (quyền sở hữu, thời điểm mua, bảo hiểm trước đó, tuổi khi được cấp phép lần đầu…); identity là người nộp đơn thực; yêu cầu là cùng bốn trục như 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."
}

Gọi lại với cùng tham số sau đó sẽ thu thập lượt duyệt đã hoàn thành. Phí bảo hiểm là chuỗi của chính trang; breakdown là nhãn của chính trang (GEICO đã in hai gói cạnh nhau); term_months cho biết số đó bao phủ những gì — $857,80 mỗi 6 tháng, không phải mỗi tháng.

{
  "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
      }
    }
  ]
}