The Agents section of the Pecta dashboard lets you see every agent that has ever reported an evaluation to your organisation, along with its lifetime statistics and current reputation score. Navigate to Agents in the sidebar to open the list view, then click any agent to open its detail view.Documentation Index
Fetch the complete documentation index at: https://docs.pecta.ai/llms.txt
Use this file to discover all available pages before exploring further.
Agents list view
The Agents list (/agents) fetches all agents registered under your API key via GET /v1/agents. Each agent appears as a row in a table with four columns:
| Column | Description |
|---|---|
| Agent | The agent_id string, rendered as a link to the detail view |
| Evaluations | Lifetime evaluation count for this agent |
| Last seen | ISO 8601 UTC timestamp of the most recent evaluation, shown to the second |
| First seen | ISO 8601 UTC date of the agent’s first recorded evaluation |
agent_id appears in an ingested event — you don’t need to register agents manually.
The table shows every agent that has ever been seen, even if it has not reported in weeks. Use the Last seen column to identify inactive agents.
Agent detail view
Clicking an agent opens the detail page (/agents/:agentId), which combines data from two API calls:
GET /v1/reputation/:agentId— the current reputation score and rolling statisticsGET /v1/events?agent_id=:agentId&limit=100— the 100 most recent events for this agent
ScoreBadge on the right.
Summary stat cards
Four stat cards appear below the header:| Card | Description |
|---|---|
| Evaluations | Total evaluation count and the agent’s current lifecycle status |
| Pass rate | Percentage of passing evaluations in the rolling 500-event window |
| Avg latency | Mean gate latency in milliseconds across the same window |
| Streak | Number of consecutive passing evaluations |
Failing gates chart
The Failing gates section renders aGateChart bar chart that breaks down gate failures across the agent’s 100 most recent events. Each bar represents a gate name and its total failure count. Gates marked skipped are excluded. This view is useful for identifying which specific gates a particular agent is struggling with, as opposed to the org-wide chart on the Overview page.
Recent events
The Recent events section displays up to 50 of the agent’s most recent evaluations in theEventFeed component, filtered to this agent only.
The ScoreBadge component
TheScoreBadge component appears in both the agent detail header and, in its smaller form, wherever scores are surfaced. It renders differently depending on the agent’s lifecycle status:
| Status | Display |
|---|---|
new | Grey badge labelled new — no evaluations yet |
calibrating | Grey badge labelled calibrating (N/50) — score not yet active |
active / mature | Numeric score (0–1000), colour-coded by range |
- 800–1000 — emerald green (high reputation)
- 600–799 — amber (moderate reputation)
- 0–599 — red (low reputation)
Score lifecycle
Every agent moves through four lifecycle stages as it accumulates evaluations. The current stage is shown in the Evaluations stat card on the detail page.| Stage | Condition | Score active? |
|---|---|---|
new | 0 evaluations | No |
calibrating | 1–49 evaluations | No |
active | 50–499 evaluations | Yes |
mature | 500+ evaluations | Yes |
The reputation score only activates at 50 evaluations for statistical reliability. Until then, the
ScoreBadge shows calibrating (N/50) so you know how far along the agent is.