Foresee

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

Dokümanlar

Foresee, AI asistanlarının her sigorta şirketi ve teminat seçeneği için ev ve otomobil sigortasını karşılaştırmasını sağlar; anında, doğru ve ayrıntılı fiyat tahminleri sunar.

Foresee Kullanımı

Foresee iki MCP sunucusu barındırır:

Kişisel bilgilerini (PII) paylaşmadan basit ve düşük engelli bir fiyat tahmini isteyen kullanıcılar şunları kullanır:

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

Fiyat tahminlerini doğrudan sigorta şirketleriyle doğrulamak isteyen kullanıcılar, Foresee'nin bilgisayar kullanım ajanlarını şu yolla devreye alabilir:

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

Her iki sunucu da kimlik doğrulaması gerektirmez.

Araçlar

Foresee, MCP sunucularında iki araç yayınlar:

Araç	Amaç	agents.	mcp.
quote_insurance	Anında, doğru ve ayrıntılı fiyat tahminleri üretir	✅	✅
live_carrier_quotes	Fiyat tahminlerini sigorta şirketleriyle doğrular	✅	❌

Araç 1: quote_insurance

Amaç: Foresee'nin desteklediği sigorta şirketlerinden, Foresee'nin hizmet verdiği hatlar ve eyaletler genelinde, tek çağrıda anında ve kalem kalem fiyat tahminleri üretir.

Girdi Parametreleri

Parametre	Tür	Zorunlu	Ayrıntılar
profile	object	evet	Profile bakın
lines	object	evet	Anahtarlar fiyatlandırılacak hatlardır (auto, home, renters); değerler o hattın teminat seçenekleridir (Teminat seçeneklerine bakın)
carriers	string[]	hayır	Varsayılan "tüm sigorta şirketleri"
include_partial	boolean	hayır	false
include_failures	boolean	hayır	true

Profil

Temel Profil

Temel bir girdi profile vardır; ayrıca otomobil ve ev/kiracı sigortası için ek bloklar bulunur. Zorunlu alanlar yalnızca yaş (veya dob), posta kodu ve (otomobil sigortası için) araç bilgileridir.

Atlanan isteğe bağlı alanlar beyan edilen varsayımlar haline gelir: muhafazakâr bir stand-in seçeriz ve bu, assumptions olarak geri bildirilir — örn. annual_mileage = 12000, fiyatı en çok değiştirecek varsayımları listeleyen bir tighten_by girdisiyle birlikte. prior_insurance, aynı hat için sigorta anlamına gelir; companion_policies, farklı bir hat için sigorta anlamına gelir.

Alan	Tür	Zorunlu
zip_code	string	evet
age	integer	evet
dob	string, YYYY-MM-DD	age için kabul edilen alternatif
city	string	hayır
gender	string	hayır
marital_status	string	hayır
education	string	hayır
employment_status	string	hayır
occupation	string	hayır
credit_range	string	hayır
home_ownership_status	string	hayır
residence_type	string	hayır
military_affiliation	string	hayır
memberships	string[]	hayır
effective_date	string	hayır
prior_insurance	object	hayır
companion_policies	string[]	hayır

Otomobil Sigortası Profili

Alan	Tür	Zorunlu
auto.vehicles[].year	integer	evet
auto.vehicles[].make	string	evet
auto.vehicles[].model	string	evet
auto.vehicles[].ownership	string	hayır
auto.vehicles[].annual_mileage	integer	hayır
auto.vehicles[].primary_use	string	hayır
auto.vehicles[].garaging_zip	string	hayır
auto.drivers[].relation	string	hayır (ilk için self)
auto.drivers[].dob	string	hayır
auto.drivers[].years_licensed	integer	hayır
auto.drivers[].accidents	object[]	hayır
auto.drivers[].violations	object[]	hayır
auto.drivers[].sr22_required	boolean	hayır

accidents ve violations, yapılandırılmış nesnelerin listeleridir; boş bir liste temiz bir kayıt anlamına gelir.

Ev ve Kiracı Sigortası Profili

Alan	Tür	Zorunlu
property.year_built	integer	hayır
property.construction_type	string	hayır
property.roof_type	string	hayır
property.square_feet	integer	hayır
property.protection_class	string	hayır
property.replacement_cost	integer	hayır
property.devices	string[]	hayır
property.losses	object[]	hayır

Teminat seçenekleri

lines içindeki her anahtar, o hattın teminat seçeneklerini alır. Hiçbir şey sunucu varsayılanında fiyatlandırılmaz: ilettiğiniz seçenekler fiyatlandırılanlardır.

Otomobil

Seçenek	Tür	Zorunlu	Kapsadığı şey
bi	string	evet	Bedensel yaralanma sorumluluğu: başkalarına verdiğiniz yaralanmalar. Kişi başına/kaza başına limit $000 cinsinden, örn. "100/300"
pd	integer	evet	Maddi hasar sorumluluğu: başkalarının araçlarına ve mülküne verdiğiniz hasar. Limit $000 cinsinden, örn. 100
coll_deductible	integer	evet	Çarpışma: kimin kusurlu olduğuna bakılmaksızın, kendi aracınızın bir kazada gördüğü hasar. Kaza başına ödediğiniz muafiyet, dolar cinsinden
comp_deductible	integer	evet	Kapsamlı: kaza dışındaki her şeyden — hırsızlık, yangın, dolu, vandalizm, hayvana çarpma — kendi aracınızın gördüğü hasar. Kaza başına ödediğiniz muafiyet, dolar cinsinden
um	string	hayır	Sigortasız/eksik sigortalı sürücü: kusurlu sürücünün hiç sigortası yoksa veya çok az sigortası varsa sizin yaralanmalarınız. Kişi başına/kaza başına limit $000 cinsinden, örn. "100/300"
medpay	integer	hayır	Tıbbi ödemeler: kimin kusurlu olduğuna bakılmaksızın sizin ve yolcularınızın tıbbi faturaları. Limit dolar cinsinden, örn. 5000

Ev

Seçenek	Tür	Zorunlu	Kapsadığı şey
coverage_a	integer	evet	Konut: evin kendisinin yeniden inşası. Limit dolar cinsinden, genellikle yenileme maliyeti
coverage_e	integer	evet	Kişisel sorumluluk: mülk üzerinde veya dışında yasal olarak sorumlu olduğunuz yaralanmalar veya hasarlar. Limit dolar cinsinden
coverage_f	integer	evet	Başkalarına tıbbi ödemeler: mülkünüzde bir yaralanma sonrası misafirin tıbbi faturaları, kimin kusurlu olduğuna bakılmaksızın. Limit dolar cinsinden
aop_deductible	integer	evet	Diğer tüm riskler muafiyeti: kendi muafiyeti olan riskler (deprem gibi) dışındaki her şey için kaza başına ödediğiniz tutar. Dolar cinsinden

B (diğer yapılar, örn. müstakil garaj veya çit), C (kişisel mülk — eşyalarınız) ve D (kullanım kaybı — evde yaşanamadığı süre boyunca yaşam maliyetleri) teminatları dolar cinsinden sorulmaz — bunlar sel içinde fiyatlandırılan Teminat A oranları olarak geri döner.

Kiracı

Seçenek	Tür	Zorunlu	Kapsadığı şey
coverage_c	integer	evet	Kişisel mülk: eşyalarınız. Limit dolar cinsinden
coverage_e	integer	evet	Kişisel sorumluluk: yasal olarak sorumlu olduğunuz yaralanmalar veya hasarlar. Limit dolar cinsinden
coverage_f	integer	evet	Başkalarına tıbbi ödemeler: evinizde bir yaralanma sonrası misafirin tıbbi faturaları, kimin kusurlu olduğuna bakılmaksızın. Limit dolar cinsinden
deductible	integer	evet	Teminat başlamadan önce kaza başına ödediğiniz tutar. Dolar cinsinden
coverage_d	integer	hayır	Kullanım kaybı: yer onarılırken taşınmak zorunda kalırsanız ek yaşam maliyetleri. Limit dolar cinsinden

Yanıt formatı

Önek	Sıklık	Anlam
Q	hat başına bir kez	Fiyatlandırılan şey: eyalet, iş kolu, teminat seçimi
format: factors:	hat başına bir kez	Aşağıdaki her şey için kendini tanımlayan açıklama
assumptions:	hat başına bir kez	Foresee tarafından yapılan varsayımlar; high_impact: true, bu alanın fiyat tahminini önemli ölçüde değiştirdiği anlamına gelir
tighten_by:	hat başına bir kez	Fiyatı en çok değiştirecek varsayımlar/eksik bilgiler
not_priced:	uygunsa	Hariç tutulan sigorta şirketleri, gerekçesiyle birlikte
C	sigorta şirketi başına bir kez	Sigorta şirketi, yazıcı kuruluş, aylık prim (nokta tahmini ve güven aralığı)
W	gerektikçe	Yukarıdaki sigorta şirketine eklenen uyarı — örn. "Eyalet minimum BI / PD yazmaz"
L	sigorta şirketi başına bir kez	Teminat veya risk başına aylık maliyet
F	sigorta şirketi başına birçok	Hat başına bir derecelendirme faktörü, factors: açıklamasında adlandırılır. Değerler L kodlarıyla birebir hizalanır: boş = o teminata dokunmaz, tek bir değer = her teminata uygulanır. Parantez, profilin indiği satırdır (100/300 gibi bir basamak, 90066 gibi bir bilgi veya applied / not applied). Değer son eki: yok = kesin, ~ = türetilmiş, ? = tahmini
D	sigorta şirketi başına	Fiyat merdivenleri: her teminat kaldıracı için, sunulan her basamak, alıntılanan aylığa karşı ±$/ay olarak, diğer her şey seçimde sabit tutularak. +0.00 seçili basamağı işaretler; (asked X) = X sunulmuyor ve fiyat en yakın sunulan basamakta kalıyor. D üzerinden yeniden fiyatlandırın; yeniden çağrı yapmayın

---

Örnek: otomobil

ZIP 90066'da 2021 Honda Civic'i olan 41 yaşında bir kişi.

Mercury düz sigorta şirketi hücresini gösterir; Travelers iki olası yazıcı kuruluş üzerinden fiyatlandırır, bu nedenle hücresi bir ci bölümü taşır (yerleştirme aralığı). USAA, sigorta şirketinin kendi gerekçesiyle not_priced içinde yer alır.

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

Atlanan her profil alanı beyan edilen bir varsayım olarak geri döner — aşağıdaki kalın assumptions: bloğu, yukarıdaki ince istekten kaynaklanır ve tighten_by:, fiyatı en çok değiştirecek yedi yanıtı listeler. Mercury düz sigorta şirketi hücresini gösterir; Travelers iki olası yazıcı kuruluş üzerinden fiyatlandırır, bu nedenle hücresi bir ci bölümü taşır (yerleştirme aralığı). USAA, sigorta şirketinin kendi gerekçesiyle not_priced içinde yer alır.

Q CA auto sel={"bi":"100/300","coll_deductible":500,"comp_deductible":500,"pd":100}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead
factors: f0=BI Limit f1=Good Driver f2=Group Placement (Rule G) f3=PD Limit f4=UMBI Limit f5=Medical Payments Limit f6=Comprehensive Deductible f7=Collision Deductible f8=Vehicle Symbol f9=ca_good_driver_pri f10=group f11=UM Limit
assumptions: [{"assumed":"Male","field":"gender","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":12000,"field":"annual_mileage","high_impact":true},{"assumed":0,"field":"accidents_3yr","high_impact":true},{"assumed":0,"field":"violations_3yr","high_impact":true},{"assumed":false,"field":"dui","high_impact":true},{"assumed":false,"field":"currently_insured","high_impact":true},{"assumed":null,"field":"homeowner","high_impact":false},{"assumed":null,"field":"occupation","high_impact":true},{"assumed":null,"field":"memberships","high_impact":true}]
tighten_by: annual_mileage,accidents_3yr,violations_3yr,dui,currently_insured,occupation,memberships
not_priced: usaa:USAA sells only to military members, veterans, and their fam
C mercury|Mercury Insurance Company|235.11
L BI:56.33,PD:44.10,UMBI:16.85,MP:0.97,COMP:17.49,COLL:99.38
F f0(100/300)=1.51,,,,,
F f1(applied)=0.8
F f2(not applied)=1.0
F f3(100)=,1.38,,,,
F f4(30/60)=,,1.65,,,
F f5(1000)=,,,1.0,,
F f6(500)=,,,,0.89,
F f7(500)=,,,,,1.0
D bi 100/300=15/30 *available through December 31, 2024:-19.03,25/50 *available through December 31, 2024:-14.18,30/60 *available on or after January 1, 2025:-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=5:-15.34,10:-12.14,15:-9.27,25:-7.99,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,CP:15.50,CL:114.33,UMBI:19.50
F f0(100000/300000)=1.649,,,,
F f8(symbol AA)=1.009?,1.003?,,,
F f9(applied)=0.8
F f10(not applied)=1.0
F f3(100000)=,1.443,,,
F f6(500)=,,0.627,,
F f8(symbol 12)=,,0.941?,,
F f7(500)=,,,0.801,
F f8(symbol 17)=,,,1.013?,
F f11(30000/60000)=,,,,1.5
F f8(symbol 1)=,,,,1.0?
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
present: Lead with the best option for this user — its price and a one-line reason — then a comparison sorted cheapest-first (Carrier · Monthly · 6-month total; a markdown table when your surface renders it) and the annual dollar spread between cheapest and priciest — that spread is the reason to compare. These are Foresee's estimates of what each carrier will charge; the assumptions and tighten_by blocks say how they were made and how to sharpen them. Foresee never takes payment: when the user settles on a carrier (or asks to buy), give that carrier's carrier_quote_url as a clickable link — the purchase completes on the carrier's own quoting portal.

Otomobil L kodları, sigorta şirketinin fiyatlandırdığı teminatlardır (birleşik BIPD veya bölünmüş BI/PD, artı çarpışma, kapsamlı, UM, ücretler). Panel genelinde normalleştirilmezler.

---

Örnek: ev

Yukarıdaki aynı 41 yaşındaki kişi, 1998'de inşa edilmiş, yenileme maliyeti 450.000 $ olan bir çerçeve evi sigortalıyor:

{
  "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'yi fiyatlandırılan Teminat A oranları olarak yansıtır. Mercury'nin L bir risk ayrıştırmasıdır (yangın, su, orman yangını, ücretler); AAA paketlenmiş bir prim dosyalar. Konut bilgileri assumptions:/tighten_by: içindedir — burada çatı tipi, koruma sınıfı ve temiz bir hasar geçmişi.

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}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead
factors: f0=Deductible f1=Coverage A f2=Multiple Policy Discount (Automobile) f3=Personal Property Replacement Cost f4=Additional Replacement Cost f5=Ordinance or Law f6=Reduced Coverage Endorsement f7=Coverage E f8=Coverage F f9=Enhanced Home Package f10=Water Backup Limit f11=Other Perils Deductible (Table 5 relativity, additive) f12=Water Deductible (Table 5 relativity, additive) f13=Coverage A / Amount of Insurance Relativity (Table 5) f14=Package Discount (Exchange auto policy)
assumptions: [{"assumed":"Asphalt Shingle","field":"roof_type","high_impact":false},{"assumed":1,"field":"stories","high_impact":false},{"assumed":2,"field":"bathrooms","high_impact":false},{"assumed":1,"field":"families","high_impact":false},{"assumed":"Primary","field":"residency_type","high_impact":false},{"assumed":5,"field":"protection_class","high_impact":true},{"assumed":"Attached","field":"garage_type","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"home_losses","high_impact":true}]
tighten_by: protection_class,home_losses
C mercury|CALIFORNIA AUTOMOBILE INS CO|123.67
L P1_FIRE:34.69,P2_LIABILITY:6.39,P3_THEFT:6.40,P4_WIND:2.68,P5_WATER:61.56,P6_OTHER:3.57,P7_CAT_WIND:0.97,P10_CAT_WATER:0.04,P12_WILDFIRE:0.43,P13_FFEQ:1.36,WC_RESIDENCE_EMPLOYEES_910:0.67,FEE:3.75,FEE:1.16,FEE:0.01
F f0(1000)=0.95,,0.887,0.963,1.0,0.909,0.963,1.0,0.95,0.95,,,,
F f1(450000)=1.895,1.206,1.142,0.901,2.519,1.176,0.901,2.519,1.518,2.313,,,,
F f2(No)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f3(No)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f4(No)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f5(0.1)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f6(No)=1.0,,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f7(300000)=,1.5,,,,1.0,,,,,,,,
F f8(1000)=,1.5,,,,,,,,,,,,
F f9(No)=,,1.0,1.0,1.0,1.0,1.0,1.0,,,,,,
F f10(No)=,,,,1.0,,,1.0,,,,,,
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 Package:139.00,MedPayIL:0.00,LiabilityIL:2.08,BrushFire:0.00,FireFollowingEQ:3.42,FEE:1.60
F f11(1000)=0.393,,,,,
F f12(1000)=1.092,,,,,
F f13(450000)=1.485,,,,,
F f14(No)=1.0,,,,,
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
present: Lead with the best option for this user — its price and a one-line reason — then a comparison sorted cheapest-first (Carrier · Monthly · 6-month total; a markdown table when your surface renders it) and the annual dollar spread between cheapest and priciest — that spread is the reason to compare. These are Foresee's estimates of what each carrier will charge; the assumptions and tighten_by blocks say how they were made and how to sharpen them. Foresee never takes payment: when the user settles on a carrier (or asks to buy), give that carrier's carrier_quote_url as a clickable link — the purchase completes on the carrier's own quoting portal.

---

Örnek: kiracı

Aynı ZIP'te farklı bir hane: 27 yaşında bir kiracı:

{
  "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}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead
factors: f0=Coverage C - Personal Property f1=Deductible f2=Coverage D - Loss of Use (% of C) f3=Additional Living Expense Term (months) f4=Contents Loss Settlement (ACV) f5=Enhanced Personal Property Coverage f6=Claims Free Discount f7=Multi-Policy Discount - Renter/auto f8=Multi-Policy Discount - Renter/life f9=Multi-Policy Discount - Renter/umbrella f10=Multi-Policy Discount - Renter/business f11=Multi-Policy Discount - Renter/boat f12=Multi-Policy Discount - Renter/motorhome f13=Multi-Policy Discount - Renter/recreational_vehicle f14=Multi-Policy Discount - Renter/cea f15=ZIP Code f16=Fireline Score f17=Experience Rating (points) f18=Coverage E - Personal Liability f19=Premises Rented to Others Solely Used as a Private Residence
assumptions: [{"assumed":2000,"field":"year_built","high_impact":false},{"assumed":5,"field":"protection_class","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"home_losses","high_impact":true}]
tighten_by: home_losses
not_priced: usaa:USAA sells only to military members, veterans, and their fam
C farmers|Fire Insurance Exchange|29.88
L PC1_PROPERTY:21.00,PC2_LIABILITY:8.17,FEE:0.42,FEE:0.30
F f0(30000)=1.087,,,
F f1(500)=1.0,,,
F f2(20)=1.0,,,
F f3(12)=1.0,,,
F f4(N)=1.0,,,
F f5(N)=1.0,,,
F f6(Y)=0.9,,,
F f7(N)=1.0,1.0,,
F f8(N)=1.0,1.0,,
F f9(N)=1.0,1.0,,
F f10(N)=1.0,1.0,,
F f11(N)=1.0,1.0,,
F f12(N)=1.0,1.0,,
F f13(N)=1.0,1.0,,
F f14(N)=1.0,1.0,,
F f15(90066)=1.423,,,
F f16(0)=1.0,,,
F f17(0)=1.0,,,
F f18(100000)=,1.0,,
F f19({})=,1.0,,
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
present: Lead with the best option for this user — its price and a one-line reason — then a comparison sorted cheapest-first (Carrier · Monthly · 6-month total; a markdown table when your surface renders it) and the annual dollar spread between cheapest and priciest — that spread is the reason to compare. These are Foresee's estimates of what each carrier will charge; the assumptions and tighten_by blocks say how they were made and how to sharpen them. Foresee never takes payment: when the user settles on a carrier (or asks to buy), give that carrier's carrier_quote_url as a clickable link — the purchase completes on the carrier's own quoting portal.

---

Örnek: paketli otomobil + kiracı

Aynı 27 yaşındaki kiracı, şimdi bir arabası var. "incidents": [] temiz bir kayıt anlamına gelir, bu nedenle sürüş kaydı soruları assumptions: tamamen boş bırakır.

{
  "profile": {
    "zip_code": "90066",
    "age": 27,
    "incidents": [],
    "prior_insurance": {"insured": true, "carrier": "GEICO", "since": "2019"},
    "auto": {"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"]
}

Artık kayıt, kilometre ve sigorta geçmişi sağladığımız için, otomobil assumptions: beş girdiye ve tighten_by: iki girdiye küçülür. Ancak, kiracı bölümü kendi konut stand-in'lerini beyan eder; Mercury yalnızca otomobili fiyatlandırır — bağımsız, paket yok. Farmers her ikisini de fiyatlandırır ve B içinde belgelenen %20 indirim sağlar. Aynı özet, structuredContent olarak bundle: {farmers: {lines, bundle_total, standalone_total, savings}} şeklinde taşınır.

Q CA auto sel={"bi":"100/300","coll_deductible":500,"comp_deductible":500,"pd":100}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead ; B carrier|bundled $/mo|standalone $/mo|saves $/mo = this carrier priced the asked lines together; the per-line C prices ARE the bundled prices
factors: f0=BI Limit f1=Good Driver f2=Group Placement (Rule G) f3=PD Limit f4=UMBI Limit f5=Medical Payments Limit f6=Comprehensive Deductible f7=Collision Deductible f8=Business & Professional Group f9=UM Limit
assumptions: [{"assumed":"Male","field":"gender","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":null,"field":"homeowner","high_impact":false},{"assumed":null,"field":"occupation","high_impact":true},{"assumed":null,"field":"memberships","high_impact":true}]
tighten_by: occupation,memberships
C mercury|Mercury Insurance Company|289.94
L BI:66.80,PD:52.55,UMBI:17.38,MP:1.05,COMP:23.50,COLL:128.67
F f0(100/300)=1.51,,,,,
F f1(applied)=0.8
F f2(not applied)=1.0
F f3(100)=,1.38,,,,
F f4(30/60)=,,1.65,,,
F f5(1000)=,,,1.0,,
F f6(500)=,,,,0.89,
F f7(500)=,,,,,1.0
D bi 100/300=15/30 *available through December 31, 2024:-22.56,25/50 *available through December 31, 2024:-16.81,30/60 *available on or after January 1, 2025:-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=5:-18.28,10:-14.47,15:-11.04,25:-9.52,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,MED:13.33,COMP:34.00,COLL:133.17,FEE:2.50
F f0(100000/300000)=1.46,,,,,,,
F f1(applied)=0.8,0.8,0.8,0.8,0.8,0.8,0.8,
F f8(not applied)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,
F f3(100000)=,1.2674,,,,,,
F f9(30000/60000)=,,1.2788,,,,,
F f6(500)=,,,,,1.0009,,
F f7(500)=,,,,,,1.1986,
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}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead ; B carrier|bundled $/mo|standalone $/mo|saves $/mo = this carrier priced the asked lines together; the per-line C prices ARE the bundled prices
factors: f0=Coverage C - Personal Property f1=Deductible f2=Coverage D - Loss of Use (% of C) f3=Additional Living Expense Term (months) f4=Contents Loss Settlement (ACV) f5=Enhanced Personal Property Coverage f6=Claims Free Discount f7=Multi-Policy Discount - Renter/auto f8=Multi-Policy Discount - Renter/life f9=Multi-Policy Discount - Renter/umbrella f10=Multi-Policy Discount - Renter/business f11=Multi-Policy Discount - Renter/boat f12=Multi-Policy Discount - Renter/motorhome f13=Multi-Policy Discount - Renter/recreational_vehicle f14=Multi-Policy Discount - Renter/cea f15=ZIP Code f16=Fireline Score f17=Experience Rating (points) f18=Coverage E - Personal Liability f19=Premises Rented to Others Solely Used as a Private Residence
assumptions: [{"assumed":5,"field":"protection_class","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"home_losses","high_impact":true}]
tighten_by: home_losses
C farmers|Fire Insurance Exchange|24.06
L PC1_PROPERTY:16.80,PC2_LIABILITY:6.54,FEE:0.42,FEE:0.30
F f0(30000)=1.087,,,
F f1(500)=1.0,,,
F f2(20)=1.0,,,
F f3(12)=1.0,,,
F f4(N)=1.0,,,
F f5(N)=1.0,,,
F f6(Y)=0.9,,,
F f7(Y - Farmers)=0.8,0.8,,
F f8(N)=1.0,1.0,,
F f9(N)=1.0,1.0,,
F f10(N)=1.0,1.0,,
F f11(N)=1.0,1.0,,
F f12(N)=1.0,1.0,,
F f13(N)=1.0,1.0,,
F f14(N)=1.0,1.0,,
F f15(90066)=1.423,,,
F f16(0)=1.0,,,
F f17(0)=1.0,,,
F f18(100000)=,1.0,,
F f19({})=,1.0,,
D deductible 500=100:+4.71,250:+1.48,500:+0.00,1000:-2.09,1500:-3.43,2500:-5.38
D coverage_c 30000=4000:-13.06,10000:-9.56,17000:-5.72,23000:-3.10,29000:-0.47,30000:+0.00,31000:+0.41,37000:+3.03,43000:+5.66,49000:+8.29,55000:+10.91,62000:+13.94,68000:+16.57,74000:+19.19,81000:+22.22,87000:+24.85,93000:+27.48,100000:+30.51,106000:+33.14,112000:+35.76,118000:+38.39,125000:+41.42,131000:+44.05,137000:+46.67,144000:+49.70,150000:+52.33
D coverage_e 100000=100000:+0.00,300000:+2.62,500000:+4.45,1000000:+8.55
B farmers|422.06|427.88|5.82
present: Lead with the best option for this user — its price and a one-line reason — then a comparison sorted cheapest-first (Carrier · Monthly · 6-month total; a markdown table when your surface renders it) and the annual dollar spread between cheapest and priciest — that spread is the reason to compare. A B row's per-line prices assume every bundled line is placed with that carrier; for a cross-carrier mix, compare standalone totals. These are Foresee's estimates of what each carrier will charge; the assumptions and tighten_by blocks say how they were made and how to sharpen them. Foresee never takes payment: when the user settles on a carrier (or asks to buy), give that carrier's carrier_quote_url as a clickable link — the purchase completes on the carrier's own quoting portal.

---

Araç 2: live_carrier_quotes

Amaç: fiyat tahminlerini sigorta şirketlerinin kendi fiyat teklifi sitelerinde doğrulamak.

Bu araç idempotenttir: ilk çağrı bilgisayar kullanım ajanlarını görevlendirir; aynı argümanlarla tekrar çağırmak, ilk çağrıdan ilerlemeyi ve sonuçları toplar.

Canlı bir gönderim, kullanıcının gerçek bilgilerini sigorta şirketlerine iletir; sigorta şirketleri yumuşak bir kredi kontrolü yapabilir. Araç çağrılmadan önce kullanıcının onayı alınır.

Foresee yalnızca fiyat teklifleri toplar; ödeme almaz veya sigorta bağlamaz.

Girdi Parametreleri

Parametre	Tür	Zorunlu	Ayrıntılar
profile	object	evet	quote_insurance ile aynı alanlar — derecelendirme bilgileri
lines	object	evet	Yürünecek hat başına bir anahtar, her değer o hattın isteğidir (aşağıya bakın); birkaç anahtar paketli yürüyüşler görevlendirir
user_authorization	string	evet	Kullanıcının sohbet içi onayı, kelimesi kelimesine (örn. yes, go ahead)
identity	object	genellikle	Kullanıcının bilgileri.
carriers	string[]	hayır	Fanı kısıtlar; varsayılan, hatlar + eyalet için doğrulanmış bir yürüyüşe sahip her sigorta şirketi

lines

Satır	Soru	Neden
auto	zorunlu — quote_insurance ile aynı dört eksen (bi, pd, coll_deductible, comp_deductible), gerçek sayılar olarak	Acentelerin taşıyıcıların formlarında sorduğu limitler ve muafiyetler
home	yok — {"home": null}	Taşıyıcının kendi formu paketini fiyatlandırır (konut tutarı, yenileme maliyeti tahmininden); acenteler seçtiğini raporlar. Sağlanan bir soru, sessizce yok sayılmak yerine yüksek sesle reddedilir
renters	zorunlu — coverage_c, coverage_e, coverage_f, deductible, gerçek dolar olarak	Acenteler, kullanıcının sayılarını formun varsayılanlarını kabul etmek yerine forma yazar; Foresee bunları asla uydurmaz

Aynı anda birkaç anahtar, paketlenmiş yürüyüşleri devreye sokar: adı geçen tüm hatları yazan her taşıyıcı, kendi çok hatlı teklif akışından geçirilir ve hat başına primleri artı kendi paket toplamını raporlar; hatların yalnızca bir kısmını yazan bir taşıyıcı, yalnızca o hatlar için yürütülür. Hat başına soru kuralları paketlemeden değişmez.

identity

Alan	Tür	Zorunlu	Ayrıntılar
first_name	string	evet	Yasal ad
last_name	string	evet	Yasal soyad
dob	string, YYYY-MM-DD	evet
street	string	evet	Sokak adresi (satır 1)
unit	string	hayır	Daire/birim (satır 2)
city	string	evet
zip_code	string	hayır	Yalnızca profildekinden farklıysa
email	string	evet	Taşıyıcılar teklifi buraya gönderir
phone	string	hayır

Yanıt

Alan	Anlam
status	in_progress / partial / complete — toplamak için aynı bağımsız değişkenlerle yeniden çağırın
agents	Taşıyıcı başına bir giriş (aşağıya bakın)
note	Sırada ne yapılacağı, ör. yeniden çağırma zamanlaması veya önceki bir çalıştırmanın sonuçlarının döndürüldüğü
authorization_recorded	Makbuzda: onay kaydı, herhangi bir taşıyıcı riski görmeden önce saklandı
skipped	Gönderilmeyen taşıyıcılar, her biri nedeniyle (no_deterministic_walk, missing_facts adı geçen gerçeklerle)
not_dispatched	Bu gönderimin yürümeyeceği motor fiyatlı taşıyıcılar, nedeniyle (held: …, no_walk, not_walked, offline, not_sold) — yürüyüş şeridinin doğrulayamadığı bir öneri asla sessizce kaybolmaz
needs	Bir missing_facts reddinde: kullanıcıdan toplanacak taşıyıcı başına gerçekler, tam şema yollarıyla — ve kapalı sözcük dağarcığı alanları için kabul edilen values
assumptions	Yürüyüşlerin beyan edilen hayır-yanıtı yanıtlarına çözdüğü doğrulanmamış küçük form gerçekleri: profil yolu (field) ve gönderilen değer (assumed) — her birini sonuçlarla birlikte iletin
confirmation	Taşıyıcı başına: anlık motor tahmini, sayfada basılan primin yanında — birkaç hat yürütüldüyse paket tahmini
error / detail	Her ret, yapılandırılmış bir {"error", "detail"} sözlüğüdür

Her agents girişi:

Alan	Ne zaman	Anlam
carrier_key, carrier	her zaman	Roster anahtarı + görünen ad
status	her zaman	in_progress / complete / failed
lines	her zaman	Bu yürüyüşün kapsadığı hatlar — paketlenmiş bir yürüyüşte birkaç tane
stage, eta_seconds_remaining	devam ediyor	Yürüyüş nerede; taşıyıcının tipik akışına karşı kalan süre
quote.premium	teklif edildi	Taşıyıcının sayfasının bastığı gibi birebir ("$857.80") — asla ayrıştırılmaz, yuvarlanmaz veya türetilmez
quote.term_months	teklif edildi	Basılan primin kapsadığı dönem
quote.premium_by_line	teklif edildi, paketlenmiş yürüyüş	Her hattın primi, sayfanın bastığı gibi, quote.premium içindeki paket toplamının yanında
quote.breakdown	teklif edildi	Sayfanın kendi satır öğeleri, kendi etiketleri
quote.bound	teklif edildi, daha yeni yürüyüşler	Fiyatlandırılmış sayfadan okunan kapsam — formun gerçekte bağladığı, sorulandan farklı olarak
quote.variants	teklif edildi	Sayfanın sunduğu ek fiyatlı paketler
quote.quote_number	teklif edildi	Sayfa bir tane gösterdiğinde taşıyıcının alma numarası
quote.evidence_recorded	teklif edildi	Ekran görüntüsü kanıtı sunucu tarafında mevcut (iç URI'ler asla kabloya binmez)
declined: true + detail	reddedildi	Taşıyıcı ayrıntıları inceledi ve teklif vermeyi reddetti. Bir yanıt, bir hata değil — iletin
detail	başarısız	Yürüyüşün kendi sözleriyle nerede ve neden durduğu

Redler

Her ret, yapılandırılmış bir {"error", "detail"} nesnesidir — aşağıdaki satır aksini söylemedikçe hiçbir taşıyıcıya hiçbir şey gönderilmedi.

Kod	Ne zaman	Ne yapılmalı
profile_required	Hane gerçekleri en üst düzeyde gönderildi, profile sarmalayıcısı yok	Gerçekleri, reddin example_arguments içinde gösterildiği gibi sarılmış olarak yeniden çağırın
authorization_required	Kullanıcının onayı olmadan çağrıldı	Onay gerçeklerini açıklayın, bir evet alın, user_authorization içinde birebir iletin
bad_identity	Bir drivers_license_number SSN gibi şekillendirilmiş	SSN'ler asla toplanmaz; lisans numarasını lisansta basıldığı gibi gönderin
bad_profile	Bir profil alanı doğrulamada başarısız olur	detail alanı adlandırır
one_line_per_dispatch	Boş bir lines haritası	Yürümek için en az bir hat adlandırın
unknown_line	Yürüyüşü olmayan bir hat (ör. umbrella)	detail, canlı gönderimin bildiği hatları listeler
coverage_selection_required	Tam limitler ve muafiyetler olmadan bir otomatik veya kiracı yürüyüşü	Sayılarla yeniden çağırın — yürüyüşler gerçek değerleri yazar, asla varsayılanları değil
bad_ask	Bir ev yürüyüşüne kapsam sorusu verildi	{"home": null} gönderin — taşıyıcının kendi formu paketini fiyatlandırır
missing_facts	İstenen hiçbir taşıyıcının formu profilden doldurulamıyor	Kullanıcıya needs[].fields[] gerçeklerini sorun (sunulduğu yerde values kullanarak) ve yeniden çağırın — aşağıya bakın
no_carriers	Hiçbir taşıyıcının o hat + eyalet için doğrulanmış bir yürüyüşü yok	quote_insurance'ye geri dönün
launch_failed	Acenteler başlatamadı	Hiçbir taşıyıcıya hiçbir şey ulaşmadı — yeniden denemek güvenlidir

---

Örnek: otomatik

Fresno'da bir hane, GEICO'nun kendi numarasını doğruluyor. Profil, GEICO'nun formunun ısrar ettiği gerçekleri taşır (sahiplik, satın alma zamanlaması, önceki sigorta, ilk ehliyet yaşı…); identity gerçek başvuru sahibidir; soru, quote_insurance ile aynı dört eksendir.

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

Daha sonra aynı bağımsız değişkenlerle yeniden çağırmak, bitmiş yürüyüşü toplar. Prim, sayfanın kendi dizesidir; breakdown sayfanın kendi etiketleridir (GEICO iki paketi yan yana bastı); term_months sayının neyi kapsadığını söyler — $857,80 6 ayda bir, ayda değil.

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