Class AIRequestBuilder

Namespace

Mythosia.AI.Builders

Assembly

Mythosia.AI.dll

Builds an independent request. Every With method returns a new builder.

public sealed class AIRequestBuilder

Inheritance

object

AIRequestBuilder

Inherited Members

object.GetType()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Extension Methods

FunctionExtensions.WithFunctions<T>(AIRequestBuilder, T)

FunctionExtensions.WithStaticFunctions<T>(AIRequestBuilder)

Remarks

Service defaults are captured by CreateRequest. Conversation history is selected at execution time and is still owned by the service; builders do not enable concurrent use of a conversation. Built-in input payloads, settings, schemas and option collections are copied. Custom content and handler targets must remain immutable or be synchronized by their owner.

Methods

GetCapabilities()

Inspects this request's captured model, endpoint and options without executing or consuming it.

public AIModelCapabilities GetCapabilities()

Returns

AIModelCapabilities

Remarks

Supported means available, not enabled. Unknown requires a caller policy; execution still validates combinations.

GetCompletionAsync(CancellationToken)

Executes this request and returns its final text.

public Task<string> GetCompletionAsync(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

Returns

Task<string>

StartRunAsync(Action<string>?, StreamOptions?, CancellationToken)

Starts this request with streaming observation, a final result and provider-supported steering.

public Task<AIRun> StartRunAsync(Action<string>? onText = null, StreamOptions? options = null, CancellationToken cancellationToken = default)

Parameters

onText Action<string>

options StreamOptions

cancellationToken CancellationToken

Returns

Task<AIRun>

WithContext(AIRequestContext)

public AIRequestBuilder WithContext(AIRequestContext context)

Parameters

context AIRequestContext

Returns

AIRequestBuilder

WithFileSearch(params FileSearchStore[])

public AIRequestBuilder WithFileSearch(params FileSearchStore[] stores)

Parameters

stores FileSearchStore[]

Returns

AIRequestBuilder

WithFrequencyPenalty(float)

public AIRequestBuilder WithFrequencyPenalty(float penalty)

Parameters

penalty float

Returns

AIRequestBuilder

WithFunctionExecution(FunctionExecutionMode, int?)

public AIRequestBuilder WithFunctionExecution(FunctionExecutionMode mode, int? maxConcurrency = null)

Parameters

mode FunctionExecutionMode

maxConcurrency int?

Returns

AIRequestBuilder

WithFunctions(params FunctionDefinition[])

Adds copied function definitions to this request; handler contracts are unchanged.

public AIRequestBuilder WithFunctions(params FunctionDefinition[] functions)

Parameters

functions FunctionDefinition[]

Returns

AIRequestBuilder

WithFunctionsDisabled(bool)

public AIRequestBuilder WithFunctionsDisabled(bool disabled = true)

Parameters

disabled bool

Returns

AIRequestBuilder

WithMaxRounds(int)

public AIRequestBuilder WithMaxRounds(int maxRounds)

Parameters

maxRounds int

Returns

AIRequestBuilder

WithMaxTokens(uint)

public AIRequestBuilder WithMaxTokens(uint maxTokens)

Parameters

maxTokens uint

Returns

AIRequestBuilder

WithPolicy(FunctionCallingPolicy)

public AIRequestBuilder WithPolicy(FunctionCallingPolicy policy)

Parameters

policy FunctionCallingPolicy

Returns

AIRequestBuilder

WithPresencePenalty(float)

public AIRequestBuilder WithPresencePenalty(float penalty)

Parameters

penalty float

Returns

AIRequestBuilder

WithProfile(AIRequestProfile)

public AIRequestBuilder WithProfile(AIRequestProfile profile)

Parameters

profile AIRequestProfile

Returns

AIRequestBuilder

WithReasoning(ReasoningLevel, CachePreservation)

public AIRequestBuilder WithReasoning(ReasoningLevel level, CachePreservation cache = CachePreservation.None)

Parameters

level ReasoningLevel

cache CachePreservation

Returns

AIRequestBuilder

WithSpeed(InferenceSpeed)

Returns a separate request selecting a processing mode. Fast opts into premium pricing.

public AIRequestBuilder WithSpeed(InferenceSpeed speed)

Parameters

speed InferenceSpeed

Returns

AIRequestBuilder

WithStatelessMode(bool)

public AIRequestBuilder WithStatelessMode(bool enabled = true)

Parameters

enabled bool

Returns

AIRequestBuilder

WithSystemMessage(string)

public AIRequestBuilder WithSystemMessage(string systemMessage)

Parameters

systemMessage string

Returns

AIRequestBuilder

WithTemperature(float)

public AIRequestBuilder WithTemperature(float temperature)

Parameters

temperature float

Returns

AIRequestBuilder

WithTimeout(int)

public AIRequestBuilder WithTimeout(int seconds)

Parameters

seconds int

Returns

AIRequestBuilder

WithTopP(float)

public AIRequestBuilder WithTopP(float topP)

Parameters

topP float

Returns

AIRequestBuilder

WithWebSearch(WebSearchOptions?)

public AIRequestBuilder WithWebSearch(WebSearchOptions? options = null)

Parameters

options WebSearchOptions

Returns

AIRequestBuilder