Skip to content
VerifAIer
Home / Docs / Dashboard
Walkthrough

Dashboard

The operational workspace over the open trust APIs.

~4 min readDifficulty: EasyPrereq: a running API

What it is

The Enterprise Dashboard is the operational front-end for the Agent Trust stack, a self-contained set of pages (Overview, Agents, Agent detail, Trust, Compliance, Risk, Quality, Passport, Reputation, Signals, Control Center, Settings) that reads the open /api/v1/* APIs.

Why it exists

Not everyone wants to call APIs by hand. The Dashboard gives governance, security and engineering teams a visual surface over trust, compliance, risk, quality, passports and reputation.

When to use it

Use it to view fleet posture at a glance, drill into a single agent, and run assessments interactively.

Where it fits / architecture position

It is the presentation layer over the same API your services call.

Dashboardbrowser
/api/v1/*open APIs
Enginestrust / risk / ...
Evidencedeterministic

Typical workflow

  • Point the Dashboard at your running API.
  • The Overview loads fleet metrics from /control-center/overview and /registry/agents.
  • Open an agent, or run an assessment from the Trust / Passport / Reputation pages.

Step-by-step usage

The Dashboard lives at demo/dashboard/. Open it and point it at your API:

# served by your API host (same origin), or opened locally
open demo/dashboard/index.html

# the client targets same-origin, or http://localhost:8000 on file://;
# override via window.VD_API_BASE or the Settings page
Screenshot
Dashboard Overview with fleet metrics and a recent-agents table (real capture added in the product-proof pass)

Inputs and outputs

Inputs: none to view (it reads the API); evidence when you run an assessment page. Outputs: rendered metrics, tables and distribution charts, plus safe empty/error states when the API is unreachable.

Real example

After the first audit, the Overview reflects the registry, e.g. total_agents: 1, average_trust_score: 100, one active passport. On a fresh install the registry is simply empty:

{
  "agents": [],
  "count": 0
}

Expected results

  • API reachable, live metrics, agents and charts.
  • API unreachable (e.g. file:// with no server), graceful empty/error states, never a crash.

Common mistakes

  • Opening the Dashboard with no API running, you'll see empty/error states; start the API first.
  • A base-URL mismatch, set window.VD_API_BASE or the Settings value to your API.

Troubleshooting

  • Everything empty: the API is unreachable, verify /health.
  • Cross-origin errors: serve the Dashboard from the same origin as the API, or enable CORS on your gateway.

Related documentation

Next: Control Center

Continue the operational walkthroughs.

Control CenterEnterprise Dashboard