# TraconOptions

> 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.traconoptions/
> Summary: TraconOptions: Defines Tracon run-time options.

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

Defines Tracon run-time options.

```csharp
public sealed class TraconOptions
```

<dl class="api-relations"><dt>Inheritance</dt><dd><a href="https://learn.microsoft.com/dotnet/api/system.object">object</a> ← <a href="/api/tracon.traconoptions/">TraconOptions</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

[Tracon.TraconOptionsValidator](/api/tracon/) performs validation manually.

## Constructors

### <a id="Tracon_TraconOptions__ctor"></a> TraconOptions\(\)

```csharp
public TraconOptions()
```

## Fields

### <a id="Tracon_TraconOptions_SectionName"></a> SectionName

Gets the default configuration section name.

```csharp
public const string SectionName = "Tracon"
```

#### Field Value

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

## Properties

### <a id="Tracon_TraconOptions_AgentGraph"></a> AgentGraph

Gets or sets limits for agent-to-agent calls.

```csharp
public TraconAgentGraphOptions AgentGraph { get; set; }
```

#### Property Value

 [TraconAgentGraphOptions](/api/tracon.traconagentgraphoptions/)

### <a id="Tracon_TraconOptions_Attachments"></a> Attachments

Gets or sets attachment upload limits for images, audio, and documents.

```csharp
public TraconAttachmentOptions Attachments { get; set; }
```

#### Property Value

 [TraconAttachmentOptions](/api/tracon.traconattachmentoptions/)

### <a id="Tracon_TraconOptions_Audit"></a> Audit

Gets or sets audit-trail options.

```csharp
public TraconAuditOptions Audit { get; set; }
```

#### Property Value

 [TraconAuditOptions](/api/tracon.traconauditoptions/)

### <a id="Tracon_TraconOptions_CircuitBreaker"></a> CircuitBreaker

Gets or sets model-provider circuit-breaker options.

```csharp
public TraconCircuitBreakerOptions CircuitBreaker { get; set; }
```

#### Property Value

 [TraconCircuitBreakerOptions](/api/tracon.traconcircuitbreakeroptions/)

### <a id="Tracon_TraconOptions_DefaultTenantId"></a> DefaultTenantId

Gets or sets the tenant identifier used when a request cannot resolve one.
A single-tenant installation always uses this value.

```csharp
public string DefaultTenantId { get; set; }
```

#### Property Value

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

### <a id="Tracon_TraconOptions_Health"></a> Health

Gets or sets model-provider health-check options.

```csharp
public TraconHealthOptions Health { get; set; }
```

#### Property Value

 [TraconHealthOptions](/api/tracon.traconhealthoptions/)

### <a id="Tracon_TraconOptions_MaxParameterValueLength"></a> MaxParameterValueLength

Gets or sets the largest byte count (UTF-8) for one `AgentParameter` value.

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

#### Property Value

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

#### Remarks

A single limit for every parameter, not one per parameter: a per-parameter
limit would have to live in [AgentParameter](/api/tracon.agentparameter/) itself and grow the
schema for a concern that is really about the request, not the definition.
Applies to a value from `AgentRunRequest.Parameters` and to an eval
case's own `EvalCase.Parameters` alike - both feed the same binder.

### <a id="Tracon_TraconOptions_ModelConcurrency"></a> ModelConcurrency

Gets or sets the per-provider outgoing concurrency limit.

```csharp
public TraconModelConcurrencyOptions ModelConcurrency { get; set; }
```

#### Property Value

 [TraconModelConcurrencyOptions](/api/tracon.traconmodelconcurrencyoptions/)

### <a id="Tracon_TraconOptions_Observability"></a> Observability

Gets or sets telemetry options.

```csharp
public TraconObservabilityOptions Observability { get; set; }
```

#### Property Value

 [TraconObservabilityOptions](/api/tracon.traconobservabilityoptions/)

### <a id="Tracon_TraconOptions_Preflight"></a> Preflight

Gets or sets the pre-flight context-window check options.

```csharp
public TraconPreflightOptions Preflight { get; set; }
```

#### Property Value

 [TraconPreflightOptions](/api/tracon.traconpreflightoptions/)

### <a id="Tracon_TraconOptions_Pricing"></a> Pricing

Gets or sets the run-cost price source.

```csharp
public TraconPricingOptions Pricing { get; set; }
```

#### Property Value

 [TraconPricingOptions](/api/tracon.traconpricingoptions/)

### <a id="Tracon_TraconOptions_RunRecording"></a> RunRecording

Gets or sets run-recording options.

```csharp
public TraconRunRecordingOptions RunRecording { get; set; }
```

#### Property Value

 [TraconRunRecordingOptions](/api/tracon.traconrunrecordingoptions/)

### <a id="Tracon_TraconOptions_Skills"></a> Skills

Gets or sets skill-loading limits.

```csharp
public TraconSkillOptions Skills { get; set; }
```

#### Property Value

 [TraconSkillOptions](/api/tracon.traconskilloptions/)

### <a id="Tracon_TraconOptions_Tools"></a> Tools

Gets or sets tool execution options.

```csharp
public TraconToolOptions Tools { get; set; }
```

#### Property Value

 [TraconToolOptions](/api/tracon.tracontooloptions/)

### <a id="Tracon_TraconOptions_UtilityModel"></a> UtilityModel

Gets or sets the default model for context-compaction summarization.

```csharp
public ModelBinding? UtilityModel { get; set; }
```

#### Property Value

 [ModelBinding](/api/tracon.modelbinding/)?

#### Remarks

This value applies when an agent definition does not provide its own
`CompactionSettings.SummarizationModel`. When this is also empty,
the agent's own model performs summarization. This avoids using an
expensive model for a low-cost task such as summarization.

### <a id="Tracon_TraconOptions_Validation"></a> Validation

Gets or sets definition-validation endpoint options.

```csharp
public TraconValidationOptions Validation { get; set; }
```

#### Property Value

 [TraconValidationOptions](/api/tracon.traconvalidationoptions/)