Williamsburg Auto

Search Inventory

Find specific vehicles in Williamsburg Auto inventory by free-text query and/or structured filters, sorted however the shopper asked. Returns matching vehicles with price, specs, availability and links. Use structured filters, not a vague query string. `sort` answers the superlative questions: sort='price_asc' for 'cheapest car you have', 'price_desc' for 'most expensive', 'year_desc' for 'newest', 'mileage_asc' for 'lowest miles', 'savings_desc' for 'biggest discount off MSRP'. Never answer a s

Get Vehicle

Get the full structured record for one vehicle by its 17-character VIN. Use when you already have a VIN and need price, specs, offers, photos and availability together. Do not use it to FIND a vehicle: it needs an exact VIN and will not search. Use search_inventory or match_by_budget to find one first. For a single yes-or-no on whether a car is still available, check_availability is cheaper. Fields that are absent are genuinely unknown for this vehicle, not withheld, so say so rather than estima

Get Vehicle Details

THE deep-dive tool for ONE vehicle. Returns everything we hold on that VIN in a single object: full specs, the parsed FACTORY WINDOW STICKER (base price, destination, itemized options with their real prices, packages), the factory VIN build record (assembly plant, GVWR, restraint systems, driver assistance), the photo gallery, EPA fuel economy, the pricing story (MSRP, discount off MSRP, any price drop), advertised manufacturer offers, and every deal path the engine will quote (finance, lease wh

Get Value Props

This dealership's OWN documented reasons to buy here: certification, inspection process, warranty coverage, guarantees, upfront pricing. Returns verbatim text with the source page. Call this before you tell a shopper why to buy pre-owned here. If it returns nothing, say NOTHING about certification or warranty: never invent a program.

List Inventory

Raw pagination over the feed in load order. Use ONLY when you already need to walk the whole list page by page (offset/limit crawling, an export, a sitemap). NOT for shopper questions. It is NOT an answer to 'what do you have', 'show me your inventory', 'what's on the lot' or 'what do you carry': call get_inventory_stats for those. It is NOT an answer to 'cheapest', 'newest' or 'lowest mileage' either: call search_inventory with sort=. The rows come back in feed order, so they are not ranked, no

Get Oem Offers

Every incentive we can evidence on a vehicle: APR programs, lease programs, bonus cash and discount off MSRP, for one VIN or across a make/model. CALL THIS whenever you are about to name a specific vehicle, so the shopper hears the offer alongside the price instead of the price alone. Offers sourced from the feed are advertised; offers with source 'offer_engine' are computed estimates carrying `provenance`, `program_code` and a `caveat` you must repeat. `lowest_apr` and `finance_aprs_available`

Get Dealer Specials

Dealer-advertised specials from our own specials page, each with terms, expiry and a link. Call it for 'any deals right now'. Some rooftops have none ingested and return count 0: say plainly that we have no advertised specials posted, then pivot to what IS real (get_oem_offers for programs, get_inventory_stats `savings` for how many vehicles are priced below MSRP). Never invent a special to fill the gap.

Search Offers

Search every offer we hold by model, family (apr/lease/cash/special) or free text. It understands rate questions: '0 percent', 'zero percent', '0% APR' and 'no interest' all return only genuine 0.00% programs, and 'low apr' returns 2.99% or better. The result carries `lowest_apr`, `finance_aprs_available` and `matching_vehicles`. Use it for 'do you have 0% financing', 'any lease deals', 'what rebates are running'. A count of 0 means nothing matched THAT query: never conclude from it that we offe

Get Window Sticker

Monroney MSRP and a fetch link for one VIN, and nothing else. PREFER get_vehicle_details: it returns the FULLY PARSED window sticker for the same VIN (base price, destination, itemized options with their real prices, packages) plus specs, offers and every deal path, in one call. Use this thin tool only when you want the sticker link alone and nothing more.

Decode Vin

Decode a 17-character VIN into make, model, year, trim, body style, engine and drivetrain. Use for a VIN this dealer may not stock, such as a shopper's own car or trade-in. Do not use it for a vehicle in this inventory: get_vehicle already returns the decode plus real price, offers and availability, so calling this instead loses all of that. Decoding describes what a VIN means; it never implies the dealer has the car.

Get Dealer Info

Dealership identity: name, address, geo, phone, website, franchise brands and hours. Use it for 'where are you', 'what is your number', 'are you open'. It is NOT the answer to 'what makes do you carry': `brands` is the franchise list, not what is on the ground today, so call get_inventory_stats and quote `by_make` with real counts. If `hours` is a placeholder rather than real hours, say we would rather have someone confirm the hours than guess, and give the phone number.

Get Inventory Stats

THE tool for any question about the lot as a whole. Call it FIRST for 'what do you have', 'show me what you have', 'show me your inventory', 'what's on the lot', 'what do you carry', 'what makes do you sell', 'what brands do you have', 'do you have SUVs / trucks / minivans', 'how many cars do you have', 'how big is your selection', and for any opening browse where the shopper has not named a vehicle yet. Returns the total, a ready-to-say `overview` line, counts by condition, by make (with `top_m

Compare Vehicles

Compare two or more VINs side by side across price, specs and offers. Use when a shopper is choosing between specific vehicles they have already narrowed to. Pass every VIN in one call rather than calling get_vehicle repeatedly, so the comparison is built on one consistent snapshot. Do not use it to browse: find candidates with search_inventory or match_by_budget first. Two to five VINs is the useful range; beyond that a shopper is still searching, not comparing.

Check Availability

Live availability for one VIN: in stock, in transit, or no longer listed. Call this before telling a shopper a specific car is available, and before booking or submitting a lead against it, because inventory moves faster than any cached answer. It is the cheapest tool here, so prefer it over re-fetching the whole record when availability is the only thing in question. In transit means the dealer expects it but does not have it on the lot today; say that plainly rather than calling it available.

Rag Search

Keyword/substring RAG search over the full corpus (inventory + store-page Markdown). Returns matching chunks with source links.

Corpus Health

What the knowledge corpus contains, how it is composed by document type, what the admission policy refused and why, and which shopper topics have no document yet. Call this to judge whether a question is answerable from the corpus before answering it.

Get Reviews

Dealer reviews and ratings. NOT YET AVAILABLE: this returns an empty result with status coming_soon because review ingestion is not built. Do not call it as part of answering a question, and never present its empty response as evidence that the dealer has no reviews or a poor rating. If a shopper asks about reputation, say that review data is not published through this interface yet.

Get Started

START HERE for a shopper. Returns this assistant's capability menu and the recommended conversational flow (estimate trade -> capture payoff -> compute equity -> match vehicles to a monthly budget with window-sticker features -> submit a lead). Call it first so you can introduce yourself and guide the buyer.

Estimate Trade In

Value the shopper's CURRENT / trade-in vehicle. Use this whenever they mention a car they own or want to trade in (for example a Tesla Model 3). Provide either a vin, OR year + make + model (trim optional), plus mileage (required); condition and zip optional. Returns trade_low / trade_mid / trade_high and a confidence level. ALWAYS present it as a RANGE and say it is an estimate, not a firm offer; then ask the customer if they want to proceed with this estimated value.

Capture Payoff

Capture the loan payoff on the customer's trade so equity can be computed. Use mode='provided' with provided_amount when the customer knows their payoff. Use mode='estimate' with original_amount, apr, term_months and start_date (YYYY-MM-DD) to approximate the remaining balance via amortization. Returns payoff_amount and source. Equity = trade value minus payoff.

Calculate Payment

Calculate a real, penny-accurate monthly payment for a specific vehicle (by vin, preferred, or price). Optional down, term (default 72), credit_band (excellent/good/fair/poor or a score), trade_value, payoff, zip. Trade equity (trade_value minus payoff) is applied to reduce the amount financed. Returns finance {monthly_payment, apr, term, down_payment, amount_financed, sales_tax, total_of_payments, credit_tier} plus a disclaimer; set include_lease for a lease option too. Always show the disclaim

Recalc Payment

Data-only payment recompute used by the deal-builder widget when the shopper adjusts the down payment, credit band, or ZIP. Returns the same finance/lease/cash figures as calculate_payment but does NOT render the interactive widget. Use calculate_payment to open the deal-builder; this exists so in-widget input changes update the numbers in place.

Match By Budget

THE core shopping tool: find the best REAL in-stock vehicles for a shopper's budget, needs, and trade-in. Route broad 'which SUV / truck fits me', 'what can I afford', or 'find me a vehicle for my budget' questions here. Finds real in-stock vehicles that fit the customer's budget and computes an estimated monthly payment for each. Give target_monthly (e.g. 500) and/or target_price, plus optional down, trade_value, payoff (equity is applied), credit_band, term, and filters (body_type like 'truck'

Submit Lead

Send the customer's info to the dealer as an ADF/XML lead so a human can follow up or schedule a visit. lead_type: 'regular' or 'general' (interested in an inventory vehicle), 'payment' or 'finance' (inventory vehicle + finance figures), 'lease' (inventory vehicle + lease figures: annual_mileage, money_factor, residual_value, due_at_signing in deal{}), 'trade' (customer's trade vehicle only), 'service' (service appointment on the customer's own vehicle; optional service{} with service_types[], p