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.