.NET API
TraconContentFilteredException
Tracon.Abstractions.dllThrown when a model provider cuts the response short with its safety or content filter.
public sealed class TraconContentFilteredException : TraconException, ISerializable- Inheritance
- object ← Exception ← TraconException ← TraconContentFilteredException
- Implements
- ISerializable
- 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”A filtered response usually arrives empty. Treating that as
“succeeded but empty” produces the hardest case to debug: the user sees a blank
answer and the record holds no trace. Tracon records it as an explicit
failure instead — RunError.Type becomes content_filtered.
Detection lives in a shared IChatClient decorator inside
Tracon.Core, not inside the provider packages, so every provider
gets the same behaviour.
Constructors
Section titled “Constructors”TraconContentFilteredException()
Section titled “ TraconContentFilteredException()”Creates a new error.
public TraconContentFilteredException()TraconContentFilteredException(string)
Section titled “ TraconContentFilteredException(string)”Creates a new error.
public TraconContentFilteredException(string message)Parameters
Section titled “Parameters”message string
The error message.
TraconContentFilteredException(string, Exception)
Section titled “ TraconContentFilteredException(string, Exception)”Creates a new error.
public TraconContentFilteredException(string message, Exception innerException)Parameters
Section titled “Parameters”message string
The error message.
innerException Exception
The underlying error.
Fields
Section titled “Fields”ContentFilteredErrorType
Section titled “ ContentFilteredErrorType”The stable value written to TraconException.ErrorType.
public const string ContentFilteredErrorType = "content_filtered"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.
FinishReason
Section titled “ FinishReason”Gets the finish reason the provider reported. For example Anthropic
refusal or Gemini SAFETY. Carries no secret.
public string? FinishReason { get; init; }Property Value
Section titled “Property Value”ProviderName
Section titled “ ProviderName”Gets the provider that filtered the response, or null when unknown.
public string? ProviderName { get; init; }