Documentation/Core Concepts/Agent Circuit Breakers

Agent Circuit Breakers

Set hard financial budget ceilings to prevent runaway recursive loops.

Agent Circuit Breakers

When building AI agents that call tools or execute multi-step recursive loops, a small bug can cause an infinite loop that burns through hundreds of dollars in minutes.

What is an AI Circuit Breaker?

Just like an electrical circuit breaker trips when a wire gets overloaded, a **VibezCheck Circuit Breaker** monitors your active inference call and halts execution immediately if your cost or token limit is reached.

How to Set Up Budget Ceilings

typescript

400 font-semibold">import { 400 font-semibold">generateText } 400 font-semibold">from 400 font-semibold">class="text-emerald-400">'ai';
400 font-semibold">import { 400 font-semibold">vibezcheck } 400 font-semibold">from 400 font-semibold">class="text-emerald-400">'400 font-semibold">vibezcheck';
 
400 font-semibold">const result = 400 font-semibold">await 400 font-semibold">generateText({
  model: 400 font-semibold">vibezcheck(400 font-semibold">class="text-emerald-400">'openai/gpt-4o', {
    customer: 400 font-semibold">class="text-emerald-400">'agent_task_102',
 
    // 🛡️ Ceilings:
    maxCostPerCallUSD: 0.25,  // Stop 400 font-semibold">if call exceeds $0.25
    maxTokensPerCall: 10_000, // Stop 400 font-semibold">if call exceeds 10,000 tokens
 
    // 🛡️ Action:
    onBudgetExceeded: (event) => {
      console.warn(400 font-semibold">class="text-emerald-400">`⚠️ Safety Trip: ${event.message}`);
    },
    throwOnBudgetExceeded: true, // Throws VibezCircuitBreakerError
  }),
  prompt: 400 font-semibold">class="text-emerald-400">'Search across 500 documents and summarize findings...',
});

Handling Tripped Events Gracefully

When a budget ceiling is reached, `vibezcheck` safely closes the stream, fires the `onBudgetExceeded` callback, and prevents any additional provider API token charges.

On this page