---
title: Agents page
description: Manage and monitor applications instrumented with Prefactor.
editUrl: true
head: []
template: doc
sidebar:
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

Every agent in your account appears here. The activity chart at the top is account-wide; agents belong to the account, not to a single environment.

## Activity chart

At the top of the page, a chart shows agent activity for the last 24 hours, broken down by span state:

- Pending
- Active
- Complete
- Failed
- Cancelled
- Terminated

## Agents list

Each entry in the list shows:

- **Agent** – the identifier assigned when the agent was registered.
- **Status** – the agent's lifecycle state: Pending, Active, Dormant, or Retired.
- **Description** – a short description of what the agent does.
- **View details** – opens the agent's detail pages.

## Registering an agent

Select **Register agent** to open the creation form. Provide a name and description, and optionally assign a **Risk profile**. Once you save, configure your SDK with the agent ID and an API token — see [Account › API tokens tab](/admin-ui/account/api-tokens) to create one and [Configuration](/sdks/configuration) for the environment variables.

When the SDK records instances, they appear in the [Agent page › Instances tab](/admin-ui/agent/instances). SDK calls authenticated with a deployment-scoped token from the [Agent page › Deployments tab](/admin-ui/agent/deployments) can omit the agent ID — the deployment supplies it.

## Related

- [Agent](/platform/concepts/agent) — what an agent is, how versions are created, and how the agent lifecycle works.
- [Agent page](/admin-ui/agent) — the fixed strip above the tabs and how the tabs fit together for a single agent.
- [Account › API tokens tab](/admin-ui/account/api-tokens) — create tokens for SDK authentication.
- [Configuration and environment variables](/sdks/configuration) — set `PREFACTOR_API_TOKEN` and `PREFACTOR_AGENT_ID` in the SDK.