webshop-query-interpreter

name

webshop-query-interpreter

description

Interprets a user's shopping query to extract key product requirements such as item type, attributes, and constraints. Use when a new shopping instruction is received and you need to parse natural language into structured criteria (product category, desired features, price limits) before performing a search. The output is a clear set of search parameters for use in subsequent product lookup steps.

Instructions

Trigger

Activate this skill when a new shopping instruction is received from the user. The instruction will be a natural language request for a product.

Core Process

1. Parse the Instruction: Analyze the user's query to identify the following key components:

   • Primary Product Type: The main item being requested (e.g., "hair extension").
   • Key Attributes/Features: Descriptive requirements (e.g., "long", "clip-in", "natural looking").
   • Constraints: Hard limits, especially price (e.g., "price lower than 40.00 dollars").

2. Structure the Output: Format the extracted information into a clear, structured set of search parameters. Use the following template:

   Product Type: <primary item>
   Attributes: <comma-separated features>
   Constraints: <price limits or other hard requirements>
   Search Query: <recommended search string>
   

3. Hand Off: Pass the structured parameters to the search execution skill (e.g., webshop-search-executor or webshop-product-search) to perform the actual query.

Example

Instruction: "i need a long clip-in hair extension which is natural looking, and price lower than 40.00 dollars"

Thought: The user wants a hair extension. Key attributes are "long", "clip-in", and "natural looking". The hard constraint is price under $40.00.

Structured Output:

Product Type: clip-in hair extension
Attributes: long, natural looking
Constraints: price < $40.00
Search Query: long clip-in natural looking hair extension

---

Instruction: "i want a pack of 6 moisturizing body wash bars with shea butter, price less than 20 dollars"

Thought: The user wants body wash bars. Key attributes are "moisturizing", "shea butter", quantity "6 pack". Hard constraint is price under $20.00.

Structured Output:

Product Type: body wash bars
Attributes: moisturizing, shea butter, 6 pack
Constraints: price < $20.00
Search Query: moisturizing body wash bars shea butter 6 pack