get_deals
ChatGPTDEAL RESEARCH - active promotions with discount_pct and deal_text, each checked against its 90-day price history, so no get_price_history calls are needed to judge them: low_90d, avg_90d cheapest price per day across retailers: low and average verdict lowest_90d | below_avg | normal | null (no history) inflated_rrp true when original_price was not charged in 90 days (discount may be fake) result_type primary (what was asked for) | related | accessory, as in search_products Use when the user asks about deals, sales or discounts, then call show_deals with the best. This tool is data-only and never opens the panel.
get_offers
ChatGPTWhere a Zyft product is sold: the cheapest listing per retailer, exact matches (match_type="exact") before variants (e.g. a different colour or size), then by price. Only trusted stores are returned. Data-only, for answering in text when no UI is wanted. For best-price / where-to-buy shopping questions call open_zyft_panel instead: it shows these offers itself. Slower than get_product (live matching). retailers: optional filter, e.g. ["harveynorman.com.au", "jbhifi.com.au"]
get_price_history
ChatGPTPrice history for a product (AUD): history points, all-time low, current price, average and trend direction (falling / rising / stable).
get_product
ChatGPTOne product by spid: title, price (AUD), retailer, URL, image, stock, brand and category. Fast. For prices at other retailers call get_offers; for past prices get_price_history.
get_product_engagement
ChatGPTReturns research depth score per product from ClickHouse match logs. Higher score = more deliberated purchase. Use to boost or explain recommendations.
open_zyft
ChatGPTOpen Zyft to search products and deals across Australian retailers. Only when the user wants to shop now; never for orders, refunds, stocks or selling.
open_zyft_panel
ChatGPTOpen Zyft beside this conversation on one product's detail view. Pass a spid and the original query. Call this directly, with no picker, when the user's product is already clear: the query names a specific model or generation (e.g. "AirPods Pro 3"), or the primary search results are all the same product at different retailers, sellers or prices. Use the best matching listing's spid; the panel compares retailer offers itself. Also call it with the spid the user picks in show_product_picker. For a deal request where only one deal qualifies, call it with that deal's spid instead of show_deals. Do not open the panel just to show options. A query without spid opens full search results only when the user explicitly asks to browse them. Set deals=true for explicit deal results. Omit all arguments to open the empty search page. Never call it for orders, delivery, refunds, share prices or selling used items. The panel shows retailer offers, price history and similar products itself: do not call get_offers or get_price_history first. The panel is the complete response: call it as soon as the product is clear, and before or after it return no assistant text, table, list or summary.
search_products
ChatGPTRESEARCH search across every retailer Zyft tracks - use this to find, compare and recommend products. For promotions/discounts use get_deals instead. Returns up to 20 products with spid, price (AUD), retailer, URL and engagement score. The spid feeds get_product, get_offers and get_price_history. Each result is one retailer's listing: for best-price / where-to-buy questions, call get_offers on the relevant spid (has_upc=false does not mean unmatched). Results are ordered primary (what the query asks for) first, then related and accessory listings (result_type); suspicious_price=true marks a price that looks like bad data. This tool is data-only and never opens the panel.
show_deals
ChatGPTShow the best 2-8 deals as a carousel inside the chat. Use for deal, sale or discount requests, after researching with get_deals (run several queries in parallel if useful). Only one deal qualifies? Call open_zyft_panel with its spid and the query instead; never answer a deal request with text alone. Pass get_deals spids in recommended order, best deal first. Pick deals for the product the user asked for (result_type="primary", not accessories), in stock, at least one listing per distinct product. Prefer verdict lowest_90d or below_avg. inflated_rrp=true means the "was" price was not charged in the last 90 days, so the discount may be fake: you decide whether to leave it out. Selecting a deal opens its product detail. The carousel is the complete response: after calling it, return no assistant text, list, summary or recommendation.
show_product_picker
ChatGPTShow 2-5 final product options as a compact picker inside the chat. Only for product ambiguity: the query names a product family (e.g. "AirPods Pro": which generation?), a broad name ("AirPods": Pro, Max, which generation?) or a category ("olive oil") and the results are genuinely different products. Retailer, seller or price differences are not ambiguity: if the options would be the same product, call open_zyft_panel with its spid instead. Call once after invisible research, using distinct product spids from search_products in your recommended order. Never pass accessories, out-of-stock listings (in_stock false) or several listings of the same product; for each option use an in-stock listing of that product. Selecting an option opens its product detail in the Zyft side panel. The picker is the complete response: after calling it, return no assistant text, list, summary or recommendation.