AI Summary

Overview

This feature creates AI-powered summaries of product reviews for specific markets, optimizing API usage and token consumption by only processing incremental review changes instead of re-evaluating all reviews repeatedly.

Data Hierarchy

Market
└── Product
└── Reviews

Workflow

High level workflow

The system generates AI-based summaries of product reviews at the market level, where each market contains multiple products and each product has multiple reviews. A scheduled cron job runs every three days and processes only those markets where the AI summary feature is enabled. For each product, the system fetches all approved reviews and generates a summary while maintaining a state of which reviews have already been processed. In subsequent runs, instead of reprocessing all reviews, the system identifies only new or previously unprocessed reviews and generates incremental summaries for them. These new summaries are then merged with the existing summary, ensuring that only delta changes are handled. This approach significantly reduces API calls, token usage, and overall billing cost while keeping the summaries up to date efficiently.

Cron Trigger
   ↓
Fetch Enabled Markets
   ↓
For Each Market
   ↓
Fetch Products
   ↓
For Each Product
   ↓
Fetch Incremental Reviews
   ↓
Generate AI Summary (Partial)
   ↓
Merge with Existing Summary
   ↓
Update State of Review

Sample Summary

{
  "overall_sentiment": "neutral",
  "summary": "The washing machine has received mixed feedback from customers. Many appreciate its quiet operation, ease of use, effective wash cycles, and range of features. However, concerns about durability, reliability, lengthy cycle times, and minor design issues have also been noted.",
  "top_positives": [
    "Quiet operation",
    "Easy to use with a variety of programs",
    "Effective wash cycles",
    "Good build quality with useful features",
    "Eco-friendly settings"
  ],
  "top_negatives": [
    "Durability issues",
    "Mechanical failures reported",
    "Long cycle times",
    "Problems with washing wool garments",
    "Installation issues leading to water leakage"
  ]
}