OptimizationOptions Class

Definition

Namespace:
Azure.AI.Projects.Agents
Assembly:
Azure.AI.Projects.Agents.dll
Package:
Azure.AI.Projects.Agents v2.1.0-beta.3
Source:
OptimizationOptions.cs

Tuning knobs and run-mode for an optimization job.

public class OptimizationOptions : System.ClientModel.Primitives.IJsonModel<Azure.AI.Projects.Agents.OptimizationOptions>, System.ClientModel.Primitives.IPersistableModel<Azure.AI.Projects.Agents.OptimizationOptions>
type OptimizationOptions = class
    interface IJsonModel<OptimizationOptions>
    interface IPersistableModel<OptimizationOptions>
Public Class OptimizationOptions
Implements IJsonModel(Of OptimizationOptions), IPersistableModel(Of OptimizationOptions)
Inheritance
Object
OptimizationOptions
Implements
IJsonModel<OptimizationOptions> IPersistableModel<OptimizationOptions> IPersistableModel<T>

Constructors

Name Description
OptimizationOptions()

Initializes a new instance of OptimizationOptions.

Properties

Name Description
EvalModel

Model deployment used for evaluation. Defaults to server config (typically 'gpt-4o').
EvaluationLevel

Evaluation granularity. Null/omitted means per-item single-turn. Set to 'conversation' for per-conversation multi-turn simulation scoring.
MaxIterations

Maximum optimization iterations per strategy. Must be >= 1. Default: 5.
OptimizationConfig

Per-target-attribute configuration overrides. Contains skills, tools, system_prompt for the agent, plus model space for model optimization.

To assign an object to the value of this property use FromObjectAsJson<T>(T, JsonSerializerOptions).

To assign an already formatted json string to this property use FromString(String).

Examples:

  • BinaryData.FromObjectAsJson("foo"). : Creates a payload of "foo".
  • BinaryData.FromString("\"foo\""). : Creates a payload of "foo".
  • BinaryData.FromObjectAsJson(new { key = "value" }). : Creates a payload of { "key": "value" }.
  • BinaryData.FromString("{\"key\": \"value\"}"). : Creates a payload of { "key": "value" }.

OptimizationModel

Model deployment for optimization reasoning (must be gpt-5 family). Falls back to the default eval model when not set.

Methods

Name Description
JsonModelCreateCore(Utf8JsonReader, ModelReaderWriterOptions)
JsonModelWriteCore(Utf8JsonWriter, ModelReaderWriterOptions)
PersistableModelCreateCore(BinaryData, ModelReaderWriterOptions)
PersistableModelWriteCore(ModelReaderWriterOptions)

Explicit Interface Implementations

Name Description
IJsonModel<OptimizationOptions>.Create(Utf8JsonReader, ModelReaderWriterOptions)
IJsonModel<OptimizationOptions>.Write(Utf8JsonWriter, ModelReaderWriterOptions)
IPersistableModel<OptimizationOptions>.Create(BinaryData, ModelReaderWriterOptions)
IPersistableModel<OptimizationOptions>.GetFormatFromOptions(ModelReaderWriterOptions)
IPersistableModel<OptimizationOptions>.Write(ModelReaderWriterOptions)

Applies to