Skip to content
PrefactorPrefactorPrefactor Docs

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 applies to instances, not spans. When you terminate a run, Prefactor closes in-flight spans as Cancelled (or leaves finished spans as they were).

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 or Active.
  • 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. Prefer a deployment-scoped token from the Agent page › Deployments tab for runtime SDKs; use Account › API tokens tab for account-wide access. See 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 can omit the agent ID — the deployment supplies it.

Section titled “Related”