Ulta Beauty

By Ulta Inc.

Overview

Get recommendations, create routines & more for makeup, skin care, hair care, fragrance & body care, plus wellness finds & more.

Tools

add_to_cart

ChatGPT

Add one or more previously shown Ulta products to the guest cart. Widget-triggered only — the model must not call this tool. Returns cart contents and a checkout continue URL for ulta.com.

get_product_details

ChatGPT

Fetch full Ulta product details for one product already shown in a bundle or search result. Requires the product sku from a prior tool result.

product_search

ChatGPT

Standalone product options and comparisons with no current buyable bundle (options/alternatives/compare/“show me a few”/which-to-pick), fragrance-only, unrelated multi-category option lists, or blocklisted brands (Dior, Chanel, Dyson, or Beyonce Parfums). Do NOT use when the guest wants an alternative inside an existing/viewed bundle—use refine_bundle for that item. Do NOT use for a buyable routine/set or total-budget bundle rebuild (search_bundles), or to redisplay a bundle (render_bundle). Returns ranked products with pdp_url links (no bundle widget).

refine_bundle

ChatGPT

Update one item in the current/viewed bundle and keep every other item as it is. Use when the guest wants the bundle they are looking at adjusted around a single product. Preserve preferences and items the guest has not changed. Do NOT use for whole-bundle total budget rebuilds like “make it under $75” (use search_bundles and reuse known preferences). Do NOT use for standalone product comparisons with no current bundle (use product_search). Only CBD products that meet applicable THC limits and other relevant legal/market restrictions are returned; products with unverified compliance are excluded. Returns a bundle_token; REQUIRED NEXT STEP: render_bundle before summarizing.

render_bundle

ChatGPT

Required after every successful search_bundles or refine_bundle: show that bundle_token in the shopping widget before describing it. Also use to redisplay the current bundle when the guest asks to see it again (e.g. “show me the bundle again”, “open the widget”) using the existing bundle_token—do not call product_search or rebuild unless the token is missing/expired. Never invent a widget rejection.

search_bundles

ChatGPT

Create a curated multi-product Ulta bundle/routine for a buyable look, set, kit, or coordinated recommendation. Prefer this over product_search for routines/goals. Also use for whole-bundle rebuilds, including budget follow-ups that rebalance the TOTAL (e.g. “make it under $75”)—reuse unchanged preferences; do not use refine_bundle for total-budget rebuilds. Not for standalone options/compare/which-to-pick with no current bundle (use product_search). Not for changing one item in a bundle the guest is already viewing (use refine_bundle). Returns priced products plus a bundle_token. REQUIRED NEXT STEP: call render_bundle with that token before summarizing.