Canary Agents Kit

Deploy experimental agent versions to small traffic slices for safe testing.

Configuration

Canary Agents Dashboard

Canaries

0/4

Traffic

26%

Health

CHECK

Customer Support v2.1.0
Traffic: 5%Err: 0.1%320ms
Sales Assistant v1.8.3
Traffic: 10%Err: 0.3%450ms
Tech Support v3.0.0
Traffic: 3%Err: 0%280ms
Billing Agent v2.5.1
Traffic: 8%Err: 0.5%510ms

Integration Code

import { createCanaryAgent } from 'agent-tools-kit/experimentation'

const canary = createCanaryAgent({
  traffic: '5%',
  healthCheck: { interval: 30_000, threshold: 0.05 },
  autoPromote: true,
  rollbackOn: 'error_rate',
})

await canary.deploy(newAgentVersion, {
  initialTraffic: 5,
  steps: [5, 10, 25, 50, 100],
  stepDelay: '24h',
})

// Monitor canary health
canary.on('metric', (m) => {
  if (m.errorRate > 0.05) canary.rollback()
})