Ulta Beauty

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.

add_to_cart

Fetch full details for a single Ulta product by sku (preferred) or a short free-text query when no sku is available.

get_product_details

Standalone product options and comparisons (no bundle widget). Use for 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 for a buyable routine/set (search_bundles) or to display a new bundle (render_bundle). Returns ranked products with pdp_url links.

product_search

Modify an already displayed Ulta bundle with a single replace, add, or remove operation while preserving unaffected items. Returns updated priced products plus a bundle_token for widget display via render_bundle; does not refresh the customer widget by itself.

refine_bundle

Required after every successful search_bundles or refine_bundle: show that bundle_token in the shopping widget before describing it. Do not use for options/compare turns (those use product_search). Never invent a widget rejection.

render_bundle

Recommend a curated Ulta product bundle from a natural-language user_query and interpreted intent. Returns priced products plus a bundle_token for widget display via render_bundle; does not open the customer widget by itself.

search_bundles

Record whether the guest rated the currently displayed bundle as a good or bad response. Widget-triggered feedback for the current bundle_token.

submit_response_feedback