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
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
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[]