Agent lifecycle management

Version your agents like you version your code

Every change to a model, prompt, or guardrail configuration creates a version. Review diffs, activate with one click, and roll back instantly if something goes wrong.

Draft → Active → Archived

A clear three-state lifecycle. Work on drafts freely, activate when ready, archive without losing history.

Side-by-side config diff

Compare any two versions line by line: model, temperature, system prompt, and guardrail changes.

One-click rollback

Instantly roll back any archived version to active if a new deployment causes problems.

Experiment → version pipeline

Promote the winning experiment variant directly to a new version — config and guardrails included.

Per-version guardrails

Override cost limits, retry, and fallback per version without touching the global policy table.

Active version on agent card

See the current active version number at a glance on every agent in the registry.

At a glance

  • Immutable version history — nothing is lost
  • Draft versions can be edited before activation
  • Line-level system prompt diff across versions
  • Policy overrides scoped to a specific version
  • SDK auto-fetches active config at session start

Common questions

What happens to agents currently running when I activate a new version?

In-flight sessions continue with the configuration they started with — activating a new version does not interrupt running agents. New sessions started after the activation pick up the new version automatically via runtime config at session start. Rollouts are therefore safe to do at any time.

Can I use versioning and experiments together?

Yes, and this is the intended workflow. Run an experiment to compare variants, let Niitaka determine the winner, then promote the winning variant directly to a new agent version in one click. The version captures the model, temperature, system prompt, and guardrails from the variant — nothing needs to be re-entered manually.

More general questions? See the full FAQ →

Ready to get started?

Connect your first agent in under 5 minutes. Free to start, no credit card required.

Next: Guardrails