.NET API
HarnessSettings
Tracon.Abstractions.dllSettings for the harness capabilities. It mirrors a safe subset of the
HarnessAgentOptions structure of Microsoft Agent Framework.
public sealed record HarnessSettings : IEquatable<HarnessSettings>- Inheritance
- object ← HarnessSettings
- Implements
- IEquatable<HarnessSettings>
- Inherited Members
- object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
Section titled “Remarks”Shell access and background agents are deliberately absent from these settings. Those two capabilities open a code execution surface on the server and need a separate security review.
Constructors
Section titled “Constructors”HarnessSettings()
Section titled “ HarnessSettings()”public HarnessSettings()Properties
Section titled “Properties”DisableAgentModeProvider
Section titled “ DisableAgentModeProvider”Gets a value that turns off the agent mode provider.
public bool DisableAgentModeProvider { get; init; }Property Value
Section titled “Property Value”DisableAgentSkillsProvider
Section titled “ DisableAgentSkillsProvider”Gets a value that turns off the agent skills provider.
public bool DisableAgentSkillsProvider { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”The provider is on only when the definition names skills
(AgentDefinition.SkillNames), and it offers only those skills;
it never reads skills from the server’s working directory. A definition
that names skills and sets this value is refused when the agent is
compiled.
DisableCompaction
Section titled “ DisableCompaction”Gets a value that turns off context compaction.
public bool DisableCompaction { get; init; }Property Value
Section titled “Property Value”DisableFileMemory
Section titled “ DisableFileMemory”Gets a value that turns off file memory.
public bool DisableFileMemory { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”File memory is off unless MemorySettings.EnableFileMemory turns
it on; it then uses the registered AgentFileStore, never a
directory of the server. A definition that sets both is refused when
the agent is compiled.
DisableTodoProvider
Section titled “ DisableTodoProvider”Gets a value that turns off todo tracking.
public bool DisableTodoProvider { get; init; }Property Value
Section titled “Property Value”DisableToolAutoApproval
Section titled “ DisableToolAutoApproval”Gets a value that turns off automatic tool approval. Once turned off, every tool call waits for an explicit approval.
public bool DisableToolAutoApproval { get; init; }Property Value
Section titled “Property Value”DisableWebSearch
Section titled “ DisableWebSearch”Gets a value that turns off web search.
public bool DisableWebSearch { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”Web search is off unless HarnessSettings.EnableWebSearch turns it on. A definition that sets both is refused when the agent is compiled.
EnableWebSearch
Section titled “ EnableWebSearch”Gets a value that turns on the model provider’s hosted web search.
public bool EnableWebSearch { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”The search runs at the model provider and is billed by it. Not every
provider surface offers it: the OpenAI Chat Completions surface accepts
it only for search models and answers 400 otherwise, while the
Responses surface (openai-responses) offers it to every model.
HarnessInstructions
Section titled “ HarnessInstructions”Gets the extra instructions passed to the harness.
public string? HarnessInstructions { get; init; }Property Value
Section titled “Property Value”Gets the loop (run-until-done) settings. null, the default, leaves the loop off.
public LoopSettings? Loop { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”Not to be confused with MaximumIterationsPerRequest, which
bounds the harness’s INNER tool-calling loop within a single invocation.
LoopSettings bounds the OUTER loop that re-invokes the whole
agent until a stop criterion is satisfied. See LoopSettings
for the comparison in full.
MaxContextWindowTokens
Section titled “ MaxContextWindowTokens”Gets the token limit of the context window. Compaction starts once it is exceeded.
public int? MaxContextWindowTokens { get; init; }Property Value
Section titled “Property Value”int?
MaxOutputTokens
Section titled “ MaxOutputTokens”Gets the upper token limit produced in a single response.
public int? MaxOutputTokens { get; init; }Property Value
Section titled “Property Value”int?
MaximumIterationsPerRequest
Section titled “ MaximumIterationsPerRequest”Gets the upper number of iterations allowed within a single request.
public int? MaximumIterationsPerRequest { get; init; }Property Value
Section titled “Property Value”int?
Methods
Section titled “Methods”Equals(object?)
Section titled “ Equals(object?)”public override bool Equals(object? obj)Parameters
Section titled “Parameters”obj object?
Returns
Section titled “Returns”Equals(HarnessSettings?)
Section titled “ Equals(HarnessSettings?)”public bool Equals(HarnessSettings? other)Parameters
Section titled “Parameters”other HarnessSettings?
Returns
Section titled “Returns”GetHashCode()
Section titled “ GetHashCode()”public override int GetHashCode()Returns
Section titled “Returns”ToString()
Section titled “ ToString()”public override string ToString()Returns
Section titled “Returns”Operators
Section titled “Operators”operator ==(HarnessSettings?, HarnessSettings?)
Section titled “ operator ==(HarnessSettings?, HarnessSettings?)”public static bool operator ==(HarnessSettings? left, HarnessSettings? right)Parameters
Section titled “Parameters”left HarnessSettings?
right HarnessSettings?
Returns
Section titled “Returns”operator !=(HarnessSettings?, HarnessSettings?)
Section titled “ operator !=(HarnessSettings?, HarnessSettings?)”public static bool operator !=(HarnessSettings? left, HarnessSettings? right)Parameters
Section titled “Parameters”left HarnessSettings?
right HarnessSettings?