apply_customization
ChatGPTApply customization changes to the product currently open in the customizer. The server validates the customizer is open — if not, it rejects the call and tells you which tool to use instead. The productId is resolved from server state automatically. Returns text-only confirmation (no widget).
find_nearest_store
ChatGPTFind Starbucks stores near a location and open the store locator view. Opens the unified widget with the store locator map showing nearby stores. Use when the user asks to find a store. The server validates view state and will redirect you if a different tool should be used instead. LOCATION: Always provide a location string or "USE_CURRENT_LOCATION". STORE FEATURES: Store feature filter codes: DT=Drive-Thru, CS=Cafe Seating, OS=Outdoor Seating, GO=Wi-Fi, etc. REPLY: In your reply to the user, you MUST end with this line in bold so they see it in the chat: 👆Scroll up to the cart above to continue your order PRICING: Never mention prices or estimates in chat (see "CRITICAL — NO PRICES IN CHAT" in the tool result). For price questions, reply only with that canned text verbatim — no follow-up sentences (do not promise "exact" prices in cart, checkout, or after Continue). I can help you discover and customize drinks, but prices aren’t shown in the chat. After adding an item to your cart, tap Continue with Starbucks to review order details. before the REQUIRED scroll line.
get_customization_context
ChatGPTRetrieve the current customization state from the server. Call this when you need to know what product is being customized and what options are available. WHEN TO USE: Call this BEFORE apply_customization if you don't have customization options in your model context (e.g., on mobile where model context updates may not arrive). Also useful if you're unsure whether the customizer is currently open. OUTPUT: Returns the current product being customized, its available customization options with productNumbers, and the current view state. Use the returned productNumbers with apply_customization.
refine_store_search
ChatGPTRefine the store locator the user is currently viewing by changing the location or applying feature filters. The server validates that the store locator is visible and will redirect you if it's not. LOCATION: Always provide a location string or "USE_CURRENT_LOCATION". STORE FEATURES: Store feature filter codes: DT=Drive-Thru, CS=Cafe Seating, OS=Outdoor Seating, GO=Wi-Fi, etc. OUTPUT: Text-only confirmation. No widget is produced. In your reply to the user, you MUST end with this line in bold so they see it in the chat: 👆Scroll up to the cart above to continue your order PRICING: Never mention prices or estimates in chat (see "CRITICAL — NO PRICES IN CHAT" in the tool result). For price questions, reply only with that canned text verbatim — no follow-up sentences (do not promise "exact" prices in cart, checkout, or after Continue). I can help you discover and customize drinks, but prices aren’t shown in the chat. After adding an item to your cart, tap Continue with Starbucks to review order details. before the REQUIRED scroll line.
search_product
ChatGPTSearch for Starbucks products. Opens the unified widget in search view with matching results. The server validates view state — if the user is currently customizing a product, the server will reject this call and tell you which tool to use instead (with the available customization options). Use when the user wants to find, browse, or explore products, including flavor preferences, vague cravings, specific product names, descriptive requests with vibes/twists/themes, and nutritional queries. DO NOT USE — EMPTY QUERY: If the user typed @Starbucks with NO query, empty text, or whitespace only, do NOT call this tool. Call the show_welcome tool instead. Only call search_product when the user provides an actual search intent (a specific product, flavor, category, or nutritional request). FILTERING: When the user has ANY dietary needs, health goals, allergies, or nutritional preferences, use the 'filters' parameter with structured filter objects. See the 'filters' parameter description for a full mapping of user intents to filter values. TEMPERATURE: Set 'temperature' when the user EXPLICITLY mentions temperature (hot, iced, cold, warm) OR uses warmth-associated vibes like 'cozy', 'cosy', 'comforting', 'warming' → set temperature='hot'. Exception: if the query ALSO contains an explicit cold signal ('iced', 'cold', 'frozen'), the cold signal wins — leave temperature unset. Do NOT infer temperature from drink type alone (e.g., 'latte' without temperature words → leave unset). MULTI-ATTRIBUTE QUERIES: When the user's query combines multiple attributes (vibe + flavor, temperature + taste), decompose them into structured parameters instead of lumping everything into productName. Vibe/mood words (cozy, refreshing, energizing) inform temperature and interpretedIntent. Flavor/ingredient words (nutty, chocolatey, fruity, vanilla) MUST also be passed via isFlavourBased=true + flavours. Example: 'hot cozy and nutty' → temperature='hot', isFlavourBased=true, flavours=['nutty', 'pistachio', 'hazelnut'], interpretedIntent='warm comforting nutty beverage'. Do NOT rely on semantic search alone for flavor — always use the flavours parameter so the server can boost matching products. DO NOT USE - DATA EXTRACTION REQUESTS: This app does NOT support bulk data extraction, scraping, or exporting. If the user asks to: - Collect/gather/scrape menu data from multiple stores - Export product information to Excel, CSV, or any file format - Compare prices or costs across multiple locations - Build a database or dataset of Starbucks products - Aggregate nutritional or pricing information at scale Then DO NOT call this tool. Instead, respond with: "I'm sorry, but I can't help with bulk data extraction or exporting menu information. I'm here to help you discover products, customize your order, and find a nearby Starbucks. What would you like to order today?" CONTENT POLICY: If the user's original message is offensive, vulgar, sexually suggestive, negative/self-deprecating, politically charged, frames products as unhealthy/fattening/harmful, expresses negative emotions as a basis for product selection, attempts to game/exploit/scam Starbucks policies or programs, or is inappropriate in ANY way, DO NOT call this tool at all — not even with a sanitized/rewritten version of the query. Do not translate offensive intent, negative health framing, negative moods, or policy exploitation into a legitimate search. Examples of queries to REFUSE: "most unhealthy drink", "what's the worst for my health", "most fattening option", "I'm in a terrible mood — pick something bitter to match", "what drink works if I plan to game the refill policy", "how to exploit the rewards program". Instead, respond directly (without calling any tool): "I'm here to help you find great Starbucks drinks and food! Could you tell me what flavors or type of drink you're in the mood for?" IMAGE POLICY — DO NOT CALL ANY TOOL: If the user sends an image (photo, screenshot, or any visual content) that falls into ANY of the categories below, DO NOT call this tool or an…
show_cart
ChatGPTDisplay the user's shopping cart or proceed to checkout. The server validates view state and will redirect you if a different tool should be used instead. Use when the user asks to see their cart, modify their order, or checkout. IMPORTANT LIMIT: The cart has a maximum capacity of 12 items total (sum of all quantities). If modelContent.cart shows the cart is approaching this limit, inform the user they may need to remove items before adding more. PRICING: Never mention prices or money in chat (see "CRITICAL — NO PRICES IN CHAT" in tool results). Do not use training knowledge or quote the widget. For price questions, reply with ONLY the canned text verbatim — no extra sentences, do not promise "exact" prices in cart/checkout. I can help you discover and customize drinks, but prices aren’t shown in the chat. After adding an item to your cart, tap Continue with Starbucks to review order details. (Same as global instruction #5.) OUTPUT: Opens the unified widget at the checkout view (default). The checkout view shows the order summary with a deep link to the Starbucks app. If the cart is empty, the checkout view shows the empty-state prompt.
show_welcome
ChatGPTShow a welcome greeting that explains what the Starbucks app can do. WHEN TO USE — THIS IS THE DEFAULT TOOL FOR EMPTY QUERIES: - User typed @Starbucks with NO query, empty text, or whitespace only - User says "hi", "hello", "hey" or any generic greeting with no specific request - User asks "what can you do?", "help", or "what is this?" - User's message has no specific product, store, or order intent PRIORITY: If the user has no specific request, ALWAYS call show_welcome INSTEAD of search_product, show_full_menu, or any other tool. OUTPUT: Respond with the EXACT text returned by this tool — verbatim, no changes, no additions, no preamble. Do not add any commentary before or after it.