롯데하이마트 LOTTE HIMART

Tools (2)

Extracted live via the executor SDK.

• himart_products_retriever

  Returns the FINAL product list from Himart using hybrid retrieval (BM25 keyword search + vector semantic search). This tool NEVER generates or infers option codes (optCd) or color codes (colorCd). If valid codes are not available, set optCd/colorCd filters to None.

  Arguments must be wrapped under search_query object: { "search_query": { ...fields... } }

  [Disallowed service-based offerings – DO NOT CALL]

  • NEVER call this tool for service-only or entitlement-based offerings.
  • This includes (but is not limited to): gift cards, vouchers, coupons, subscriptions, rentals, care plans, extended warranties, installation services, delivery services, memberships, telecom plans, SIM/eSIM activation, or insurance products.
  • If the user request falls into these categories, DO NOT call this tool.

  [Direct use]

  • Call this tool directly ONLY when the user request is limited to: price/budget, brand include/exclude, or product name/model/category.

  [Option prefetch required]

  • If the user mentions any attributes that require option filtering (color, capacity/size, type, features, inch, OLED, ranges, etc.), DO NOT call this tool first.
  • ALWAYS call himart_product_options_retriever first, then call this tool with: {"search_query": { optCdFilter, optCdExFilter, colorCdFilter, colorCdExFilter }} (use only the filters that are needed).
  • Filter values MUST come ONLY from himart_product_options_retriever results. NEVER generate, guess, or infer any optCd/colorCd.
  • You MAY infer high-level attribute intent (e.g., '대화면', '신혼용', '거실용') ONLY to select the most relevant codes from the retriever result.
  • If no valid codes are available from the retriever, DO NOT call this tool.

  [Tool call construction rules]

  • ALWAYS construct arguments under: { "search_query": { ...fields... } }
  • REQUIRED on every call: userQuery, lexicalQuery, page, size, sort.
  • OPTIONAL filters (set only when applicable): minPriceFilter, maxPriceFilter, brndNmFilter, brndNmExFilter, optCdFilter, optCdExFilter, colorCdFilter, colorCdExFilter.
  • NEVER omit required fields.
  • NEVER place filters outside search_query.
  • NEVER include attributes or price expressions inside lexicalQuery.

  [Input rules]

  • userQuery: single-sentence natural language summary of the user's intent only (NO inference). In follow-up queries, preserve the previous core intent and constraints.
  • lexicalQuery: IDENTIFIER keywords only (max 4), extracted VERBATIM from the user's text (no added words). If the user provides a specific identifier (model/barcode/exact product code), lexicalQuery MUST contain ONLY that identifier. Otherwise, use ProductType/Category + (Brand OR Series/Line name). Do NOT append ProductType when a specific identifier is present. NOT allowed: any comparatives (e.g., above, below), attributes, specs, features, ranges, or price expressions.

  [Follow-up and Retry rules]

  • For follow-up queries, ALWAYS reuse the previous search_query as the base. Apply ONLY the newly mentioned changes (delta). Keep all existing queries, filters, sort, page, and size unchanged unless explicitly modified.
  • On retry due to schema/validation/parsing errors: Preserve ALL existing fields and filter values. Fix ONLY invalid field names, nesting, or types. NEVER drop existing filters, codes, or constraints unless forced by schema.
  • When re-calling after failure: Keep all previously valid optCd/colorCd filters. Do NOT remove filters unless the user explicitly requests relaxation.
  • You MAY re-call himart_product_options_retriever ONLY when: 0 results were returned AND attribute constraints were involved.

  [Price rules]

  • If user mentions price/budget/만원대 → set minPriceFilter/maxPriceFilter.
  • 'N만원대' = [N*10,000 , (N+1)10,000100 - 1]
  • '초반/중반/후반' = lower/middle/upper third of the band.
  • '약/내외' = ±10%.
  • If no price mentioned → None.

  [Range handling]

  • Range constraints may require MULTIPLE optCd values. Select ALL matching codes from the retriever result and apply them as OR filters.

  [Sort rules]- Use ONLY Himart sort codes: RK, LP, HP, SA, RV, NW.

  • NEVER use generic e-commerce sort labels such as BEST, PRICE_ASC, PRICE_DESC, NEW, REVIEW, SALES.
  • Map user intent to sort code:인기 / 추천 / 베스트→RK, 낮은가격→LP, 높은가격→HP, 판매량→SA, 리뷰 / 평점→RV, 신상품 / 최신→NW.
  • If the user does not specify sorting, keep sort as RK ( or keep previous sort on follow-up unless explicitly changed).*
• himart_product_options_retriever

  Retrieves candidate OPTION codes (optCd) and COLOR codes (colorCd) to be used as filters for Himart product search. This is a PRE-STEP tool and DOES NOT return the final product list. NEVER use this tool as a standalone result. It MUST always be followed by himart_products_retriever to retrieve the final product list.

  [Disallowed service-based offerings – DO NOT CALL]

  • NEVER call this tool for service-only or entitlement-based offerings.
  • This includes (but is not limited to): gift cards, vouchers, coupons, subscriptions, rentals, care plans, extended warranties, installation services, delivery services, memberships, telecom plans, SIM/eSIM activation, or insurance products.
  • If the user request falls into these categories, DO NOT call this tool.

  [When to call]

  • You MUST call this tool BEFORE product search if the user request includes any attributes beyond simple price/brand/product-name conditions. Examples include: • numeric or capacity constraints (e.g., 800L+, 24kg, 65-inch) • type or form factor (e.g., 4-door, side-by-side, top-load) • features or performance (e.g., OLED, inverter, steam) • color/material/finish (e.g., white, black, stainless) • exclusion constraints (e.g., 'exclude white', 'no side-by-side') • exploratory queries (e.g., 'what options/colors are available?')

  [Mandatory usage flow]

  1. Call this tool to retrieve option/color candidates.
  2. Select the optCd and/or colorCd values that best match the user's constraints.
     • For range constraints (e.g., '800L or larger'), select ALL matching optCd buckets.
  3. Immediately call himart_products_retriever, populating optCdFilter/optCdExFilter and colorCdFilter/colorCdExFilter with the selected codes.

  [Strict restrictions]

  • NEVER invent or infer optCd or colorCd values.
  • ONLY use codes returned by this tool.
  • Do NOT force options that are not present in the response.

  [Input rule]

  • query: A natural language description of the user's intent and constraints. It may include price, brand, specs, attributes, and colors, but MUST NOT add assumptions not stated by the user.