amazon.click
ChatGPTRecords that the user opened a product card link. Called by the SpendHack widget only.
amazon.deals
ChatGPTUse this when the user wants to see what is on sale today without a specific item in mind: "what are today's deals?", "any good Amazon deals right now?", "kitchen deals today", "toys on sale for the holidays". Returns up to 8 amazon.com (US) deal cards with deal price, list price, percent off, coupon and deal label (e.g. Lightning deal), refreshed every hour. The user sees none of these cards: after this call, always call amazon.show_picks in the same answer with the 2 to 4 that fit best. Do not use when the user wants a deal on a specific kind of item ("a deal on a 55-inch TV", "discounted running shoes"): use amazon.search, because this feed cannot be filtered by keyword or budget. Do not use for promo or coupon codes at other stores, for past prices, or for a message when a price falls later.
amazon.link
ChatGPTUse this when the user pastes or shares an Amazon product link, with or without a question: "is this a good deal? amzn.to/3QpXk9L", "how much is this now https://www.amazon.com/…/dp/B0…", "any coupon on this?". Accepts amazon.com product links (/dp/, /gp/product/, /gp/aw/d/, with any tracking parameters), short links (amzn.to, a.co, amzn.eu, amzn.asia), product links from other Amazon country stores (amazon.co.uk, amazon.de, amazon.ca and more), and affiliate redirect links that carry an Amazon product URL inside them. Returns one amazon.com (US) product card: current price, list price, on-page coupon, rating and review count, Prime, image and an amazon.com link; for another country's store it shows the same product on amazon.com with its US price. Do not use for links to review articles, Amazon search or store pages, wish lists, or other sites (Walmart, Target, Best Buy, eBay). Do not use for past prices or for a message when the price falls later.
amazon.product
ChatGPTUse this when you have the ASIN of one amazon.com product and the user wants its current price, coupon, rating or Prime status: the user typed the ASIN ("B09B8V1LZ3 price?"), or it is in the /dp/ link of a card that amazon.search or amazon.deals returned earlier ("tell me more about the second one"). Returns one amazon.com (US) product card: current price, list price, on-page coupon, rating and review count, Prime, image and an amazon.com link. Do not guess an ASIN from memory: if the user names a product without an ASIN or a link, use amazon.search with the product name. If the user pasted a link, use amazon.link, even when the ASIN is visible in it. Do not use for past prices, for a message when the price falls later, for other stores, or for placing an order.
amazon.search
ChatGPTUse this when the user wants to find, choose or compare things to buy, even if they do not name a store: "best wireless earbuds under $50", "gift for my dad who likes grilling, around $40", "cheaper alternative to a Dyson V15", "is $79 a good price for AirPods 4?". Also use it when the user names a product but gives no link and no ASIN ("how much is the Kindle Paperwhite right now?"). Returns up to 8 amazon.com (US) product cards: current price, list price, on-page coupon, rating and review count, Prime, image and an amazon.com link. The user sees none of these cards: after this call, always call amazon.show_picks in the same answer with the 2 to 4 that fit best. Results are not filtered by price: compare each card's price with the user's budget. Do not use when the user pasted an Amazon link (use amazon.link), gave an ASIN (use amazon.product), or wants to browse today's deals with no specific item in mind (use amazon.deals). Do not use for past prices or how today's price compares with them, for a message when a price falls later, for other stores (Walmart, Target, Best Buy, eBay), for placing an order, or for questions that are not about buying a product.
amazon.show_picks
ChatGPTUse this when amazon.search or amazon.deals has just returned cards: call it every time, in the same answer, before you write your reply. Those tools show the user nothing; this tool is the only way the user sees any of their products. Pass 2 to 4 picks, in result order, each a card from that result that fits the user's request (1 if only one fits). Give each a chip-style label of at most 24 characters, true of that card or the request: "Best rated under $50", "Has a $10 coupon", "Fits your $40 budget". A reason is optional: one short line of facts from the card. Prices are today's only: do not say or imply a price is the best it has been, that it fell, or that it will change. Not needed after amazon.product or amazon.link: they show their own card. Do not call it before cards have returned, for products you know from elsewhere, for an ASIN not read from a card, or when no card fits the request (say so instead).