.NET API
TraconRunBudgetExceededException
Tracon.Abstractions.dllThrown when a run tree’s token or cost budget runs out mid-run, between two model turns.
public sealed class TraconRunBudgetExceededException : TraconException, ISerializableInheritance
Section titled “Inheritance”object ← Exception ← TraconException ← TraconRunBudgetExceededException
Implements
Section titled “Implements”Inherited Members
Section titled “Inherited Members”TraconException.ErrorType, Exception.GetBaseException(), Exception.ToString(), Exception.GetType(), Exception.TargetSite, Exception.Message, Exception.Data, Exception.InnerException, Exception.HelpLink, Exception.Source, Exception.HResult, Exception.StackTrace, object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
Section titled “Remarks”Thrown by the wrapper installed inside the tool-call loop, one layer
before the raw provider client; Microsoft Agent Framework’s
function-invoking client does not catch it, so it propagates out of
AIAgent.RunAsync/RunStreamingAsync and fails the run.
This is a different fault from AgentRunBudget refusing to reserve a new child run (AgentRunBudget.TryReserveRun): that refusal is returned to the model as an ordinary tool result and the calling agent can recover; this exception ends the run that hit it.
Constructors
Section titled “Constructors”TraconRunBudgetExceededException()
Section titled “ TraconRunBudgetExceededException()”Creates a new error.
public TraconRunBudgetExceededException()TraconRunBudgetExceededException(string)
Section titled “ TraconRunBudgetExceededException(string)”Creates a new error.
public TraconRunBudgetExceededException(string message)Parameters
Section titled “Parameters”message string
The error message.
TraconRunBudgetExceededException(string, Exception)
Section titled “ TraconRunBudgetExceededException(string, Exception)”Creates a new error.
public TraconRunBudgetExceededException(string message, Exception innerException)Parameters
Section titled “Parameters”message string
The error message.
innerException Exception
The underlying error.
Fields
Section titled “Fields”RunBudgetExceededErrorType
Section titled “ RunBudgetExceededErrorType”The stable value written to TraconException.ErrorType.
public const string RunBudgetExceededErrorType = "run_budget_exceeded"Field Value
Section titled “Field Value”Properties
Section titled “Properties”ErrorType
Section titled “ ErrorType”Gets the stable error type name written to the run record.
public override string ErrorType { get; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”Defaults to the full name of the exception type, so today’s behaviour does
not change. A derived type overrides this member when the record has to be
machine readable — for example TraconContentFilteredException
writes content_filtered. Reports and alert rules can rely on this
stable name instead of an assembly name.
The value is written to RunError.Type and carries no secret.