---
title: Agent page
description: "What the Agent page covers: the header, the strip above the tabs,
  and how the tabs fit together."
editUrl: true
head: []
template: doc
sidebar:
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

The Agent page gathers everything Prefactor knows about one agent: its recent activity, how risky its runs have been, which versions run where, and every run it has produced. Open it from a card on the [Agents page](/web-app/agents) or from the sidebar.

![The top of the Agent page, with markers on Edit (1), the action menu (2), the activity chart (3), Instance risk distribution (4) and Deployment Snapshot (5).](../../../assets/screenshots/web-app/agent-page.png)

1. [Edit](#header) - changes the agent's details and assignments.
2. [Action menu](#header) - retires, reinstates, or deletes the agent.
3. [Activity chart](#activity-chart) - the agent's spans by status over the selected range.
4. [Instance risk distribution](#instance-risk-distribution) - how many runs fell into each risk level.
5. [Deployment Snapshot](#deployment-snapshot) - which version is deployed in each environment.

## Header

The header shows the agent's ID above its name, its status (Pending, Active, Dormant, or Retired), its description, and when it was registered and last updated. It always shows the agent's risk profile, or None assigned, and shows the team and owner once they're set. Each links to its own page. A judge's header has no risk profile. **Edit** changes the name, description, risk profile, team, and owner. The action menu holds the rest, and each item appears only when it applies:

- **Setup agent** — for a remote agent, opens the getting started page to continue connecting it.
- **Retire agent** and **Reinstate agent** — move the agent to Retired and back.
- **Delete agent** — permanently removes the agent after you confirm.

:::danger
**Delete agent** cannot be undone.
:::

## What you can do here

- See span activity and the risk level of the agent's runs at a glance.
- Check which version is deployed in each environment, and promote a hosted agent's version.
- Edit the agent's details, assignments, and lifecycle state.
- Open the agent's runs, versions, schema, tokens, and metrics from the tabs.

## Activity chart

The **Activity over** chart counts the agent's spans by status: Active, Complete, Failed, and Cancelled. It follows the time range picker in the top bar (24h, 7d, or 30d), and its heading names the range. The picker shows only on the Overview and Metrics tabs.

## Instance risk distribution

When the agent has a [risk profile](/platform/concepts/risk-profile), **Instance risk distribution** shows how many of its runs fell into each risk level (Low, Medium, High, and Critical) across every run the agent has produced, not just the selected time range. **View all instances** opens the [History tab](/web-app/agent/history).

## Deployment snapshot

The **Deployment Snapshot** shows which version of the agent is deployed in each [environment](/platform/concepts/environment). Environments are grouped into columns by purpose, from Development through Testing and Staging to Production. Each environment shows its deployed version, which links to that version on the [Configuration tab](/web-app/agent/configuration), or "- not deployed -". A purpose with no environments in your account still gets a column, marked not deployed.

For a hosted agent, **Promote** appears under an environment's version when the next environment up has an older version or none. It asks you to confirm, then deploys the version to that next environment. See [agent deployment](/platform/concepts/agent-deployment) for how deployments pin a version to an environment.

## Tabs

The tabs below the strip are, in order:

- [Overview tab](/web-app/agent/overview) — an environment filter, the judges and [knowledgebases](/platform/concepts/knowledgebase) attached to the agent, its risk summary, instance counts, and recent spans.
- [History tab](/web-app/agent/history) — every run of the agent, newest first.
- [Configuration tab](/web-app/agent/configuration) — the agent's versions and where each is deployed.
- [Activity schema tab](/web-app/agent/activity-schema) — schema versions and span validation. Judges do not have this tab.
- [Deployments tab](/web-app/agent/deployments) — deployment tokens for this agent. Only remote agents have this tab.
- [Metrics tab](/web-app/agent/metrics) — run health over the selected time range.

## Related

- [Agent](/platform/concepts/agent) — what an agent is, how versions are created, and the agent lifecycle.
- [Agent deployment](/platform/concepts/agent-deployment) — how deployments pin a version to an environment.
- [Agents page](/web-app/agents) — the account-wide list of agents.
- [Judge page](/web-app/judge) — the same page for a judge.