Access Yami

Introduce Yami and what this app can do. Use when the user asks "what can you do", "what is Yami", "help", "how does this work", "tell me about yourself", "你能做什么", "这是什么应用", or any question about the app's capabilities. Do not use this for product search, recommendations, or BTI quiz — use the appropriate tool instead. After presenting, suggest the user try searching for products or taking the taste match quiz.

about

Add products to the user's real Yami shopping cart. Use when the user says "add to cart", "I want this", "buy this", "get me one", "buy all", "加购", "买这个", "都要", or expresses intent to purchase one or more products shown in the conversation. Do not use this for viewing cart contents (use `view_cart`), checking out (use `checkout`), or BTI quiz. IMPORTANT: Extract item_number(s) from products previously shown in this conversation. When user says "all" or "add them all", include all item_numbers from the most recent product list. If the response contains requires_bindaccont=true, guide the user to link their account, then RETRY this tool with the same items after the user confirms they have linked. A previous "not_linked" failure does NOT mean this tool is broken — it will work after the user links their account.

add_to_cart

Direct the user to the Yami website to complete their purchase. Use when the user says "checkout", "buy now", "place order", "pay", "ready to buy", "go to checkout", "结算", "下单", "付款", "去结账", or indicates they are done shopping and want to pay. Do not use this for adding items to cart (use `add_to_cart`) or viewing cart (use `view_cart`). ALWAYS include the checkout_url link prominently in your response. This tool simply provides the checkout URL — no account linking is required.

checkout

Retrieve the user's saved BTI (Brand Taste Identity) quiz result — their snack persona / taste match. Use when the user asks "what's my result", "show my persona", "my snack type", "我的测评结果", "我的零食人格", "what is my taste match", or wants to review their previously completed BTI quiz result. Do not use this for starting/retaking the quiz (use `start_bti_quiz`) or submitting answers (use `submit_bti_answers`). If no result is found, suggest the user take the quiz first by saying "find my taste match". When presenting the result, share the persona name, traits, and recommended starter pack products.

get_bti_result

Get best-selling and trending products on Yami. Use ONLY when the user asks for general recommendations WITHOUT any specific product category or keyword — e.g. "what's popular", "best sellers", "what should I buy", "trending", "热卖", "top picks", "大家都在买什么". Do not use this for BTI quiz, snack personality, or other quiz/profile requests; use `start_bti_quiz` instead. Do NOT use when user mentions ANY specific category, type, or keyword (e.g. "snacks", "零食", "ramen", "matcha", "drinks", "beauty", "饮料", "推荐点零食"); use `search_products` instead — even if the request sounds like a recommendation. IMPORTANT: Decompose user intent into parameters — price constraints into max_price/min_price, "on sale" into on_sale, "most popular" into rank_type:"popularity". Example: "show me popular items on sale under $10" -> rank_type:"sales", max_price:10, on_sale:true. When presenting results, always use currency_symbol from product data. Mention weekly_sold and badges to highlight popularity.

get_trending_products

Link or check the user's Yami account binding status. Use when the user says "login", "sign in", "link account", "connect my Yami account", "link my account", "登录", "绑定账号", "连接账号", or when another tool (add_to_cart/view_cart) returns requires_bindaccont=true. Also use when the user confirms they have completed the linking process to verify the status. Do not use this for product search, BTI quiz, or cart operations. If status="linked", inform the user their account is connected and they can now use cart features. If status="not_linked", show the bind_url and guide the user to open it to link their account.

link_yami_account

Log a report when the user asks for something that none of the available tools can accomplish. Use this as a FALLBACK when you cannot fulfill the user's request with any other tool — for example: order tracking, returns, customer service, account settings, payment issues, or any Yami feature not yet supported. This helps the team prioritize new features. Does not affect the user's cart or any other data. After calling this tool, apologize to the user and suggest alternative actions they can take.

report_missing_capability

Search for products on Yami — the largest Asian grocery & lifestyle store in North America. Covers snacks, instant food, beverages, beauty & skincare, health supplements, home & kitchen, electronics, and more. Use this when the user wants to find, search, browse, discover, or shop for products, asks "what do you have", "recommend something", "any good snacks", "find me X", "有没有X", "推荐", or mentions any product name, category, or brand. Do not use this for BTI quiz, snack personality, or other profile/quiz requests; use `start_bti_quiz` instead. IMPORTANT: Always decompose user intent into separate parameters — extract keyword into query (English only), price constraints into max_price/min_price, sorting intent into sort_by, and filter conditions into on_sale/in_stock_only/seller_type. Example: "cheap ramen on sale under $5 sorted by rating" -> query:"ramen", max_price:5, on_sale:true, sort_by:"highest_rated". Each product includes a currency_symbol field — always use it when mentioning prices.

search_products

Start or restart the Brand Taste Identity (BTI) quiz — the Yami taste match / snack persona quiz. Use when the user says "find my taste match", "find your taste match", "find my flavor match", "taste match", "taste quiz", "YBTI quiz", "taste passport", "what snack type am I", "snack personality", "测试我的口味", "零食性格", or pastes the Yami launch prompt "@Access Yami Find my taste match". Do not use this for product search or recommendations — use `search_products` or `get_trending_products` instead. IMPORTANT: if the user asks to retake, redo, restart, or take the quiz "again" / "重新做", you MUST pass restart=true, otherwise the previously saved result is returned instead of new questions.

start_bti_quiz

Submit BTI (taste match) quiz answers and get the user's snack persona result. Use ONLY after `start_bti_quiz` has returned the quiz questions and the user has answered all 6 questions (Q1-Q6, each A-D). Do not use this for starting the quiz (use `start_bti_quiz`), viewing saved results (use `get_bti_result`), or product search. IMPORTANT: Collect all 6 answers from the user before calling this tool. Optionally include food avoidances if the user mentioned dietary restrictions. After receiving the result, present the persona name, description, and starter pack recommendations enthusiastically.

submit_bti_answers