# AI Enricher Properties (text-based) AI Enricher Properties use intelligent prompts to analyze your products and create valuable new data points that enhance your catalog. ### Before you begin * Set up your product feeds and ensure data is flowing into Crobox * Create the product properties you'll use as inputs and outputs * Ensure you have properties with the "AI Enricher" value type available in your property list ## Create your AI Enricher property Navigate to **Product Data > Properties** and either create a new property or edit an existing one. 1. Set the **Value Type** to "AI Enricher" 2. Choose your **Target Level** (Product or Variant) 3. Configure basic property settings: * **Lock being edited in the app** - Prevents manual editing of AI-generated values * **Mark as internal** - Keeps the property for internal use only * Set validation rules if needed for your outputs {% hint style="success" %} AI Enricher properties can be best organized when you have clear, descriptive property names that indicate their purpose, like "AI Generated Description" or "Style Category AI." {% endhint %} ## Configure AI enrichment settings In the **AI Enrichment Settings** section, configure the property in this order: {% hint style="info" %} Set a product filter before activation. The **Enable automated background enrichment** toggle only becomes available after you define which products should be processed. This helps you validate results on a smaller subset before enriching a larger part of your catalog. {% endhint %} {% stepper %} {% step %} **Write your prompt** Create a clear, specific prompt that tells the AI exactly what you want to extract or generate. Your prompt should include clear instructions, for example: ``` Extract the following properties from the title: - the player name, never include the shirt_nr (e.g. Lionel Messi) - team (e.g. Barcelona) - league (e.g. La Liga) ``` {% hint style="success" %} **Prompt best practices:** * Use clear, actionable language * Provide specific examples * Define the expected output format * Include constraints to avoid unwanted results {% endhint %} {% endstep %} {% step %} **Configure input properties** Select the **Inputs** that the AI will analyze: * Choose properties containing the source data for enrichment * Multiple inputs can provide richer context * Common inputs include titles, descriptions, categories, or specifications {% endstep %} {% step %} **Define output properties** Select the **Outputs** where enriched data will be stored: * These properties will receive the AI-generated values * You can select multiple outputs for different extracted attributes * Output properties should already exist in your property setup {% hint style="warning" %} Make sure your output properties can accommodate the type of data the AI will generate. {% endhint %} {% endstep %} {% step %} **Set the product filter** Use **Only for these products** to define which products are eligible for enrichment. Start with a narrow subset so you can validate the generated values before scaling up: * A specific category or brand * Products missing a target attribute This filter is required. You can only activate enrichment after setting it. {% endstep %} {% step %} **Test with preview** Click **Fetch Preview Values** to test your setup on products that match your filter. Review the preview table to check: * Input data being analyzed * AI-generated output values * AI explanations showing the reasoning Refine your prompt or filter until the results look right. {% endstep %} {% step %} **Activate enrichment** Turn on **Enable automated background enrichment** after your preview looks correct. When enabled, Crobox processes only the products that match your filter during background enrichment. {% endstep %} {% endstepper %} ## Testing with preview Use the **AI Enrichment Preview** to validate your setup before activation: 1. Click **"Fetch Preview Values"** to test your prompt on sample products 2. Review the preview table to see: * Input data being analyzed * AI-generated output values * AI explanations showing the reasoning 3. Use and adjust **Add Filter** to test different product subsets 4. Refine your prompt based on preview results The preview shows up to 20 products and includes an **AI Explanation** column that reveals how the AI interpreted your prompt and source data. ## Save and monitor 1. Click **Save** to store your configuration 2. Turn on **Enable automated background enrichment** if you have not already done so 3. Monitor enrichment progress in the **Insights** tab: * View enrichment coverage statistics * See value distribution across your catalog * Check for validation errors * Track which experiences use this property The insights dashboard shows exactly how many products have been enriched and provides detailed breakdowns of the generated values. ## Review and refine

Check enrichment quality

  • Review the generated values for accuracy
  • Look for patterns in the validation errors
  • Verify that outputs match your expectations

Optimize your prompt

  • Refine instructions based on actual results
  • Add examples for edge cases you discovered
  • Adjust constraints to improve consistency

Monitor performance

Use the Insights tab within output properties to track:

  • Product Value Insights - See distribution of enriched values
  • Validation Errors - Identify data quality issues
  • Connections - Track where this property is used in experiences
## Common use cases #### :diagram-project: Product categorization Extract categories, styles, or attributes from product titles or descriptions: ``` From the product title, identify the clothing style category. Options: Casual, Formal, Athletic, Vintage, Contemporary Only return one category that best matches. ``` #### :right-left-large: Attribute extraction Pull specific product details from unstructured text: ``` Extract these details from the product description: - Material (fabric type only) - Care instructions (washing temperature) - Country of origin Format as: Material | Care | Origin ``` #### :text: Content generation Create marketing copy or enhanced descriptions: ``` Create a concise product highlight (max 15 words) that emphasizes: - Key product benefits - Unique selling points Use an engaging, sales-focused tone. ``` ## Troubleshooting #### AI outputs are inconsistent * Refine your prompt with more specific instructions and examples * Add constraints to limit possible outputs * Test with preview using different product samples #### Enrichment isn't running * Check the filter - Add or review **Only for these products** first, since activation depends on it * Check the toggle - Ensure **Enable automated background enrichment** is active * Verify filters - Make sure your product filter is not too restrictive * Review inputs - Confirm input properties contain data for your target products #### Preview shows errors * Validate prompt syntax - Ensure instructions are clear and actionable * Check input data - Verify input properties have values for preview products * Simplify outputs - Start with fewer output properties to isolate issues #### Values don't appear in experiences * Check property connections - Use the Insights tab to see where properties are used * Verify property settings - Ensure target level (Product/Variant) matches your needs * Review validation rules - Make sure generated values pass validation ## FAQs
How long does AI enrichment take to process my products? Processing time depends on your catalog size and prompt complexity. Small catalogs (under 1,000 products) typically complete within minutes, while larger catalogs may take several hours. The system processes products in batches in the background.
Can I use the same property as both input and output? While technically possible, it's not always recommended as it can cause data conflicts. Create separate properties for inputs and outputs to maintain data integrity and clear audit trails.
What happens if my prompt generates invalid data? Invalid outputs are can be caught when previewing output. You can refine your prompt and re-run enrichment to fix these issues, or "Remove enriched data" to clear existing AI-generated values if needed.
Can I stop enrichment once it's started? You can disable "Enable automated background enrichment" to prevent new products from being processed, but you can't cancel in-progress batch operations. Use "Remove enriched data" to clear existing AI-generated values if needed.
How do I know which products have been enriched? The Insights tab in the output properties shows detailed statistics including total products, value distributions, and coverage percentages. You can also filter the product catalog to show only products that have a value by targeting your output property.
What's the difference between AI Enricher and manual enrichment? AI Enricher Properties automatically generates values using prompts and existing data, while manual enrichment requires individually assigning values to products. AI Enricher scales better for large catalogs but requires careful prompt engineering for accuracy and user UAT.
### What's next * [ ] **Create Product Finder experiences** using your enriched data for better product discovery * [ ] **Set up Campaigns** that leverage AI-generated attributes for targeted messaging * [ ] **Monitor performance** through analytics to measure the impact of enriched data --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.crobox.com/how-to-guides/product-data/ai-enricher-properties-text-based.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.