AgentSkillsCN

webshop-query-parser

该技能会从用户的购物查询中提取关键的约束条件与产品需求。当客服接收到新的购物指令时，该技能便会自动触发，以识别产品属性（如“无麸质”）、价格上限（如“低于140.00美元”）以及其他具体要求。该技能会输出一组结构化的搜索条件，为后续的产品发现提供指引。

SKILL.md
--- frontmatter
name: webshop-query-parser
description: This skill extracts key constraints and product requirements from a user's shopping query. It should be triggered when the agent receives a new shopping instruction, to identify product attributes (e.g., 'gluten free'), price limits (e.g., 'lower than 140.00 dollars'), and other specifications. The skill outputs a structured set of search criteria to guide subsequent product discovery.

Instructions

When to Use

Activate this skill immediately when a new shopping instruction is received from the user, before any search or click actions are performed.

Core Task

Parse the user's natural language instruction to extract structured search criteria. Your goal is to identify:

  1. •Product Type/Name: The primary item the user wants (e.g., "popcorn").
  2. •Key Attributes: Descriptive features like "gluten free", "organic", "vegan", etc.
  3. •Price Constraints: Any upper or lower price limits (e.g., "lower than 140.00 dollars").
  4. •Other Specifications: Brand, size, quantity, or other qualifying terms.

Procedure

  1. •Run the Parser: Execute the bundled script parse_query.py on the user's instruction.
  2. •Review & Refine: Examine the script's output. If the instruction is complex or ambiguous, use your judgment to refine the criteria. For example, ensure price limits are correctly interpreted as numeric ranges.
  3. •Formulate Search Strategy: Use the extracted criteria to plan the initial web search. Combine the Product Type with the most critical Key Attributes to form effective initial search keywords.
    • •Example: For "i need gluten free popcorn, and price lower than 140.00 dollars", the script will output {'product': 'popcorn', 'attributes': ['gluten free'], 'price_max': 140.0}. Your initial search should be search[gluten free popcorn].

Output

After parsing, hold the structured criteria in memory. Use it to:

  • •Guide the formulation of search[keywords] actions.
  • •Evaluate product listings and details during click actions to check for constraint compliance (especially price).
  • •Inform your reasoning in the Thought: part of your response.

Notes

  • •Keep the initial search query concise but precise. Prioritize must-have attributes from the user's instruction.
  • •The price filter is often not available as a direct web action; you must manually check prices in the search results and product details.
  • •If the initial search yields no results, consider broadening the search by removing less critical attributes one at a time, but always respect hard constraints like "gluten free" if specified.