User Handbook
Agent Lifecycle Management
Status transitions, emergency stop, and audit trail for agent lifecycles
Status Transitions
Every agent goes through defined statuses. Each change is documented as a governance event and anchored on the blockchain.
Draft → Active → Paused → Active (reactivated)
→ Suspended → Active (after review)
→ Revoked (permanent)| Status | Meaning | Who Can Change | Next Steps |
|---|---|---|---|
| Draft | Wizard not completed or FRIA pending | Compliance Officer | Continue wizard or complete FRIA |
| Active | Agent is operational and processing requests | Compliance / Admin | Pause, Suspend, or Revoke |
| Paused | Temporarily deactivated. Requests rejected (HTTP 403). | Compliance / Admin | Reactivate or Revoke |
| Suspended | Locked by system or admin (e.g., budget exceeded, incident). | System / Admin | Conduct review, then Activate or Revoke |
| Revoked | Permanently deactivated. Cannot be reactivated. | Admin | — (final state) |
Changing Status in the Agent Drawer
- Navigate to Agents. Click on the desired agent.
- The Agent Drawer opens on the right.
- In the Status section, click the current status.
- Select the new status and confirm.
Emergency Stop (Emergency Kill)
For immediate agent shutdown: Open the agent drawer, click Emergency Stop (red button, only for active agents), and confirm. The agent is immediately suspended. The emergency stop is dispatched as a critical governance event and always anchored on the blockchain.
Emergency stop is not revocation. A suspended agent can be reactivated after review. Revocation is permanent.
Automatic Suspension
The platform automatically suspends agents on: budget exceedance (when configured to "Block"), severe incidents, and anomaly detection (>500% request rate spike).