Lifecycle Management

Manage agent states from draft to production with version control, rollback, and A/B testing between versions.

Agent States

Every agent goes through a lifecycle of states:

drafttestingactivesuspendedarchived

draft — New agent, being configured. Not available for production use.
testing — Under validation. Can run in sandbox/simulation mode.
active — Live in production. Receives real traffic.
suspended — Temporarily paused. No new runs allowed.
archived — Retired. Preserved for audit trail but cannot run.

Promote an Agent

Promote Agentbash

# Promote from draft to testing
curl -X POST http://localhost:8000/api/v1/lifecycle/AGENT_ID/promote \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "target_state": "testing" }'

# Promote from testing to active (production)
curl -X POST http://localhost:8000/api/v1/lifecycle/AGENT_ID/promote \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "target_state": "active" }'

Version Control

Every configuration change creates a new version snapshot:

Version Controlbash

# List all versions of an agent
curl http://localhost:8000/api/v1/lifecycle/AGENT_ID/versions \
  -H "Authorization: Bearer YOUR_API_KEY"

# Rollback to a previous version
curl -X POST http://localhost:8000/api/v1/lifecycle/AGENT_ID/rollback \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "version": 3 }'

A/B Testing

Use the A/B testing feature to route a percentage of traffic to a new version. Compare performance metrics before fully promoting.

Budgets

Multi-Agent