AnalyticsDashboardResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amigo/main/json-schema/amigo-analytics-dashboard-response-schema.json",
  "title": "AnalyticsDashboardResponse",
  "description": "Composite dashboard — six headline KPIs, each with a delta, plus the period length.\n\nHigher-is-better for ``call_volume``, ``avg_quality``, ``tool_success_rate``;\nhigher-is-worse for ``escalation_rate``, ``avg_ttfb_ms``, ``avg_duration_s``.\nConsumers must color deltas by that per-KPI polarity, not by delta sign alone.",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amigo-analytics-api-openapi.yml#/components/schemas/AnalyticsDashboardResponse",
  "properties": {
    "call_volume": {
      "$ref": "#/$defs/AnalyticsKpi",
      "description": "Total calls in the period"
    },
    "avg_quality": {
      "$ref": "#/$defs/AnalyticsKpi",
      "description": "Average quality score (0-100); higher is better"
    },
    "avg_ttfb_ms": {
      "$ref": "#/$defs/AnalyticsKpi",
      "description": "Average audio time-to-first-byte in ms; lower is better"
    },
    "escalation_rate": {
      "$ref": "#/$defs/AnalyticsKpi",
      "description": "Fraction of calls escalated; lower is better"
    },
    "tool_success_rate": {
      "$ref": "#/$defs/AnalyticsKpi",
      "description": "Fraction of tool calls that succeeded; higher is better"
    },
    "avg_duration_s": {
      "$ref": "#/$defs/AnalyticsKpi",
      "description": "Average call duration in seconds"
    },
    "period_days": {
      "type": "integer",
      "title": "Period Days",
      "description": "Length of the reporting period in days"
    }
  },
  "type": "object",
  "required": [
    "call_volume",
    "avg_quality",
    "avg_ttfb_ms",
    "escalation_rate",
    "tool_success_rate",
    "avg_duration_s",
    "period_days"
  ],
  "$defs": {
    "AnalyticsKpi": {
      "properties": {
        "value": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Value",
          "description": "Current-period value (None when no data)"
        },
        "delta_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Delta Pct",
          "description": "Percent change vs the previous period, or None"
        }
      },
      "type": "object",
      "title": "AnalyticsKpi",
      "description": "A single headline KPI with its period-over-period change.\n\n``value`` is left broad (int for counts, float for rates/scores/durations,\n``None`` when the metric has no data for the period). ``delta_pct`` is the\nsigned percent change vs the previous equal-length period, or ``None`` when\na prior-period comparison is unavailable."
    }
  }
}