AgentOptimizationJob interface

Agent optimization job resource — a long-running job that produces candidate changes to a Foundry agent configuration.

Properties

created_at

The timestamp when the job was created, represented in Unix time.

display_name

Human-readable label. Omitted when no label is needed; it has no uniqueness, routing, or idempotency semantics.

error

Error details — populated only on failure.

id

Server-assigned unique identifier.

optimization_configuration

Type-specific optimization configuration.

optimization_model_configuration

Model used to generate candidate changes. An existing deployment name is also accepted.

result

Result produced on success.

run_duration_ms

Duration for which the job has been running, in milliseconds.

status

Current lifecycle status.

target_configuration

Foundry agent whose configuration is optimized. Omitted when the workflow does not target a registered Foundry agent.

updated_at

The timestamp when the job was last updated, represented in Unix time.

warnings

Non-fatal warnings emitted during optimization. Omitted when no warnings were produced.

Property Details

created_at

The timestamp when the job was created, represented in Unix time.

created_at?: Date

Property Value

Date

display_name

Human-readable label. Omitted when no label is needed; it has no uniqueness, routing, or idempotency semantics.

display_name?: string

Property Value

string

error

Error details — populated only on failure.

error?: ErrorModel

Property Value

id

Server-assigned unique identifier.

id?: string

Property Value

string

optimization_configuration

Type-specific optimization configuration.

optimization_configuration: AgentOptimizationConfigurationBaseUnion

Property Value

optimization_model_configuration

Model used to generate candidate changes. An existing deployment name is also accepted.

optimization_model_configuration: AgentOptimizationModelConfiguration

Property Value

result

Result produced on success.

result?: AgentOptimizationJobResult

Property Value

run_duration_ms

Duration for which the job has been running, in milliseconds.

run_duration_ms?: number

Property Value

number

status

Current lifecycle status.

status?: JobStatus

Property Value

target_configuration

Foundry agent whose configuration is optimized. Omitted when the workflow does not target a registered Foundry agent.

target_configuration?: AgentOptimizationTargetConfigurationUnion

Property Value

updated_at

The timestamp when the job was last updated, represented in Unix time.

updated_at?: Date

Property Value

Date

warnings

Non-fatal warnings emitted during optimization. Omitted when no warnings were produced.

warnings?: string[]

Property Value

string[]