Intelligence Views

Analytics

Analytics is a retained intelligence page with three focused views: root cause, reliability, and value. It is not a generic dashboard builder or export center.

/analytics

Overview#

The page concentrates on operator questions that matter during governance review: where cost is coming from, which agents look reliable, and which agents are generating the most value for their spend.

This is narrower than the older analytics story. The page does not promise arbitrary charting, plan-based retention tiers, or a separate report authoring workflow.

Prerequisites#

Prerequisites

Recent synced agent and cost data so the intelligence endpoints have something to analyze
Access to the Web console at `/analytics`

Expected Results#

When data is available, expect:

-A root-cause tree for recent spend
-Reliability ranking and per-agent breakdown details
-Value comparison across agents with activity, success, and cost efficiency

Web Operations#

Use the three tabs according to the investigation you are running.

Root Cause

Start here when cost moved unexpectedly. The page shows recent totals, comparison to the previous window, and a tree that breaks contribution down by the available dimensions.

Reliability

Use reliability to compare agents against each other, then open one agent for the weighted score breakdown. This is for operational ranking, not for editing the scoring model from the page.

Value

Use value view to compare activity volume, success contribution, total cost, and cost-per-success. It is the quickest way to spot agents that are expensive without delivering much return.

CLI Operations#

CLI mirrors the same three retained intelligence views:

Terminal

$ ap analytics root-cause --days 7

Inspect reliability rankings or one specific agent:

Terminal

$ ap analytics reliability --days 7

Compare value metrics:

Terminal

$ ap analytics value --days 30

FAQ#

Q: Why does the page show no data?

A: The page depends on recent synced operational data. If agents have not run recently, or cost and session data is empty, the intelligence views remain blank.

Q: Can I export analytics directly from this page?

A: Not as a dedicated export center. For scripted access use the CLI JSON output; for lightweight summaries use the Reports surface.

Q: How far back can I analyze?

A: The current retained surfaces focus on recent windows backed by the available stored data. Use CLI flags such as `--days` or `--date-to` to control the analysis window when the endpoint supports it.