💬

Explanation Agent

Stage 4

Overview

The Explanation Agent translates validated anomalies into clear, neutral, user-facing explanations. It uses only observational language, references underlying data, and includes visual references for charts, timelines, and comparisons. No psychological interpretation or moral judgment.

Key Features

Neutral language enforcement

Observational phrasing only

Data-backed statements

Visual reference generation

Confidence level inclusion

Message range references

Visual References

Bar charts (message counts, response times)

Line charts (activity trends, intensity)

Timelines (message distribution, gaps)

Comparisons (before/after changes)

Metrics (ratios, durations, counts)

Tables (detailed breakdowns)

Code Example

const ExplanationAgent = require('./explanation-agent.js');

// Initialize with validated anomalies
const explainer = new ExplanationAgent(validatedAnomalies);

// Generate explanations
const insights = explainer.generateExplanations();

// Output format
{
  "insights": [
    {
      "summary": "Messages from Alice show increased frequency from day 5 onward, with an average of 8.5 messages per day compared to 4.2 messages per day in the initial period.",
      "related_message_range": "45-120",
      "confidence_level": 0.88,
      "visual_references": [
        {
          "type": "line_chart",
          "title": "Message Frequency Over Time"
        }
      ]
    }
  ]
}

API Integration

Endpoint

/api/generate-explanations

Test Coverage

14/14 tests passing (100%)

Package Size

11 KB

Processing Speed

Instant generation

Resources