src.analysis.ai_insights

AI-powered insights using OpenAI GPT-4.

Module Contents

class src.analysis.ai_insights.AIInsightEngine(api_key: str | None = None)[source]

Generate AI-powered insights using GPT-4.

generate_executive_summary(df: pandas.DataFrame, period_metrics: pandas.DataFrame, market_concentration: Dict[str, Any]) → str[source]

Generate executive summary of findings.

Parameters:

  • df – Full time series DataFrame

  • period_metrics – Aggregate period metrics

  • market_concentration – Market concentration metrics

Returns:

Executive summary text

explain_anomalies(df: pandas.DataFrame, anomalies: pandas.DataFrame) → List[Dict[str, str]][source]

Generate statistical descriptions of detected anomalies.

Parameters:

  • df – Full DataFrame

  • anomalies – DataFrame of anomalous points

Returns:

List of anomaly descriptions

generate_competitive_insights(period_metrics: pandas.DataFrame) → str[source]

Generate statistical competitive analysis.

Parameters:

period_metrics – Aggregate metrics per brand

Returns:

Statistical competitive analysis text

generate_recommendations(df: pandas.DataFrame, period_metrics: pandas.DataFrame) → Dict[str, str][source]

Generate statistical profiles per brand (NOT strategic recommendations).

Parameters:

  • df – Full time series

  • period_metrics – Aggregate metrics

Returns:

Dictionary mapping brand to statistical profile