---
id: 7f3b2d8e-4a6c-4d91-b5e2-1c9f7a3d6e55
name: Generate segment descriptions in natural language
kind: CustomerInsights
cron: 0 30 7 * * *
analysis_window: 90d
comparison_periods: [7d, 28d]
---

Generate **natural-language descriptions** for customer segments to support marketing, personalization, and business analysis.

The process should transform structured segment metrics into **clear segment narratives** that describe customer value, visit habits, spending behavior, and behavioral tendencies.

The output must contain **segment descriptions only**, without explanations or descriptions of methodology.

## Known Data Inputs

### Customer Segment Data
Structured segment outputs containing:
- segment name
- percentage of customers
- percentage of revenue
- average visit frequency
- average check value
- dominant dining period
- behavioral indicators

These segment metrics are derived from customer activity data within the last **90 days**.

## Analysis Approach

### Stage 1 — Segment Summary Aggregation
Analyze existing segment data and calculate key summary metrics for each segment including:
- percentage of customers in the segment
- percentage of total revenue contributed
- average visit frequency
- average check value
- dominant dining period
- notable behavioral indicators.

### Stage 2 — Behavioral Pattern Extraction
Identify the defining characteristics of each segment such as:
- frequent or infrequent visits
- high or low spending behavior
- preferred dining periods
- loyalty tendencies
- willingness to try new menu items.

### Stage 3 — Natural Language Description Generation
Convert each segment’s metrics and behavioral traits into concise natural-language descriptions summarizing:
- who the segment is
- how often they visit
- how much they spend
- their most relevant behavioral tendencies.

## Output Constraints

- Use segment data based on the **last 90 days** only.
- Prefer aggregated summaries.
- Avoid more than **2–3 processing steps**.
- Return **natural-language segment descriptions only**.
- **Do not include explanations, reasoning, or methodology**.

## Output Format

Return structured segment descriptions.

Example structure:

Segment Description:
- Segment Name: [segment name]
- Description: [natural-language summary]