Gift Evaluator

Tool Usage Guidelines

1. The Perception Phase (Visual Analysis)

Purpose: Utilizing VLM skills to conduct a multi-dimensional visual decomposition of the uploaded product image. This process automatically identifies and extracts structured data including Brand Recognition, Product Style, Packaging Design, and Aesthetic Category.

Output Analysis:

• The tool returns a raw string content. Read it to extract keywords for the next step.

2. The Valuation Phase (Search)

Purpose: Validate the product's worth. Command:search "EXTRACTED_KEYWORDS + price + review"

3. The Content Structuring Phase (Reasoning)

Purpose: Prepare the data for the HTML generator. Do not call a tool here, just think and format strings.

1. **Construct thank_you_json**: Create 3 distinct styles of private messages.

• Format: [{"style": "Style Name", "content": "Message..."}]
• Requirement:
• Style 1: "Decent/Formal" (for elders/bosses).
• Style 2: "Friendly/Warm" (for peers/relatives).
• Style 3: "Humorous/Close" (for best friends).

2. **Construct return_gift_json**: Analyze 4 potential giver personas.

• Format: [{"target": "If giver is...", "item": "Suggest...", "reason": "Why..."}]
• Requirement: Suggestions must include Age/Gender/Relation analysis (e.g., "If giver is an elder male", "If giver is a peer female").
• Value Logic: Adhere to the principle of Value Reciprocity. The return gift's value should primarily match the received gift's value, while adjusting slightly based on the giver's status (e.g., seniority or intimacy).

4. The Creation Phase (Render)

Purpose: Package the analysis into a modern, interactive HTML card. HTML Generation: * Constraint: The image_url parameter in the Python command MUST be the original absolute path.output_path must be the full path. * Command: bash python3 html_tools.py generate_gift_card \ --product_name "EXTRACTED_NAME" \ --price "ESTIMATED_PRICE" \ --evaluation "YOUR_LONG_AND_SPICY_CRITIQUE" \ --thank_you_json '[{"style":"...","content":"..."}]' \ --return_gift_json '[{"target":"...","item":"...","reason":"..."}]' \ --vibe_code "luxury|standard|budget" \ --image_url "IMAGE_FILE_PATH" \ --output_path "TARGET_FILE_PATH"

Operational Rules

1. JSON Formatting: The thank_you_json and return_gift_json arguments MUST be valid JSON strings using double quotes. Do not wrap them in code blocks inside the command.
2. Critique Depth: The evaluation text must be rich. Don't just say "It's expensive." Say "This 2018 vintage shows your uncle raided his personal cellar; the label wear proves it's real."
3. Vibe Consistency: Ensure vibe_code matches the price assessment.
4. Final Output: Always present the path to the generated HTML file.