Agents page
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
Section titled “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
Section titled “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
Section titled “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 to create one and Configuration for the environment variables.
When the SDK records instances, they appear in the Agent page › Instances tab. SDK calls authenticated with a deployment-scoped token from the Agent page › Deployments tab can omit the agent ID — the deployment supplies it.
Related
Section titled “Related”- Agent — what an agent is, how versions are created, and how the agent lifecycle works.
- Agent page — the fixed strip above the tabs and how the tabs fit together for a single agent.
- Account › API tokens tab — create tokens for SDK authentication.
- Configuration and environment variables — set
PREFACTOR_API_TOKENandPREFACTOR_AGENT_IDin the SDK.