# TraconCircuitBreakerOptions

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/api/tracon.traconcircuitbreakeroptions/
> Summary: TraconCircuitBreakerOptions: Defines circuit-breaker options that temporarily stop requests after a model provider returns consecutive failures.

<div class="api-provenance">Namespace Tracon · Assembly <code>Tracon.Core.dll</code></div>

Defines circuit-breaker options that temporarily stop requests after a model
provider returns consecutive failures.

```csharp
public sealed class TraconCircuitBreakerOptions
```

<dl class="api-relations"><dt>Inheritance</dt><dd><a href="https://learn.microsoft.com/dotnet/api/system.object">object</a> ← <a href="/api/tracon.traconcircuitbreakeroptions/">TraconCircuitBreakerOptions</a></dd><dt>Inherited Members</dt><dd><a href="https://learn.microsoft.com/dotnet/api/system.object.gettype">object.GetType()</a>, <a href="https://learn.microsoft.com/dotnet/api/system.object.tostring">object.ToString()</a>, <a href="https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object)">object.Equals(object?)</a>, <a href="https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object-system-object)">object.Equals(object?, object?)</a>, <a href="https://learn.microsoft.com/dotnet/api/system.object.referenceequals">object.ReferenceEquals(object?, object?)</a>, <a href="https://learn.microsoft.com/dotnet/api/system.object.gethashcode">object.GetHashCode()</a></dd></dl>

## Remarks

The circuit breaker decorates the `AI.IChatClient` pipeline instead
of being embedded in a provider implementation. Every provider, including
OpenAI, compatible servers, and future Anthropic or Gemini providers, gets
the same protection.

## Constructors

### <a id="Tracon_TraconCircuitBreakerOptions__ctor"></a> TraconCircuitBreakerOptions\(\)

```csharp
public TraconCircuitBreakerOptions()
```

## Properties

### <a id="Tracon_TraconCircuitBreakerOptions_BreakDuration"></a> BreakDuration

Gets or sets the duration to wait after opening the circuit before one
half-open retry.

```csharp
public TimeSpan BreakDuration { get; set; }
```

#### Property Value

 [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)

### <a id="Tracon_TraconCircuitBreakerOptions_Enabled"></a> Enabled

Gets or sets whether the circuit breaker is enabled. When disabled,
requests always reach the provider and no consecutive-failure counter is kept.

```csharp
public bool Enabled { get; set; }
```

#### Property Value

 [bool](https://learn.microsoft.com/dotnet/api/system.boolean)

### <a id="Tracon_TraconCircuitBreakerOptions_FailureThreshold"></a> FailureThreshold

Gets or sets the consecutive failure count required to open the circuit.

```csharp
public int FailureThreshold { get; set; }
```

#### Property Value

 [int](https://learn.microsoft.com/dotnet/api/system.int32)