WeightedEnsembleChatClientOptions
Options & Configuration · AiDotNet.Configuration
Controls how a weighted ensemble picks a model, what it does when one fails, and what it reports as.
For Beginners
These settings apply to a group of models used together. The seed makes the choice of model repeatable, so running your search twice picks the same models both times. The fallback setting decides whether a failure moves on to another model or gives up. The model id is just the name the group reports for itself.
How It Works
The setting that matters most here is Seed. Model selection is randomness inside an experiment,
and randomness inside an experiment has to be controllable or the experiment is not repeatable. Seeding the
selection stream means two runs of the same search choose the same models in the same order, so a difference
in outcome is attributable to the change under test rather than to which model happened to be picked on
iteration 40. The reference OpenEvolve ensemble seeds Python’s process-global generator from the first model’s
configuration only, which the rest of the process shares and can advance at any time.
FallbackOnError decides what a member’s failure costs. With it on, a failing member’s turn is
handed to the next-heaviest member instead of losing the iteration entirely — which matters most on the
rate-limited endpoints where a mixed ensemble is worth having in the first place.
Constructors
| Constructor | Summary |
|---|---|
WeightedEnsembleChatClientOptions() |
Properties
| Property | Summary |
|---|---|
ChatOptions DefaultChatOptions { get; set; } |
Gets or sets settings applied to every member’s calls beneath that member’s own settings. |
bool FallbackOnError { get; set; } |
Gets or sets whether a failing member’s turn passes to the remaining members in weight order. |
bool StampAnsweringMember { get; set; } |
Gets or sets whether a response with no model id is stamped with the answering member’s name. |
int MaxParallelism { get; set; } |
Gets or sets the maximum number of members called at once by a call-every-member request. |
string ModelId { get; set; } |
Gets or sets the model id the ensemble reports, or null for "ensemble". |
ulong Seed { get; set; } |
Gets or sets the seed for the member-selection stream. |
ulong Stream { get; set; } |
Gets or sets the stream selector, so two ensembles sharing a seed still draw independently. |
Methods
| Method | Summary |
|---|---|
WeightedEnsembleChatClientOptions Clone() |
Creates an independent copy so a running client is unaffected by later mutation. |
void Validate() |
Validates the parallelism bound and the reported model id. |