3030
3131
3232class BenchmarkOutcomeScenarioOutcomeFailureReason (BaseModel ):
33- """Failure information if the scenario failed or timed out.
34-
35- Contains exception type and message.
36- """
33+ """Information about why a scenario execution failed"""
3734
3835 exception_message : str
3936 """The exception message providing context"""
@@ -60,10 +57,7 @@ class BenchmarkOutcomeScenarioOutcome(BaseModel):
6057 """Duration of the scenario execution in milliseconds."""
6158
6259 failure_reason : Optional [BenchmarkOutcomeScenarioOutcomeFailureReason ] = None
63- """Failure information if the scenario failed or timed out.
64-
65- Contains exception type and message.
66- """
60+ """Information about why a scenario execution failed"""
6761
6862 scenario_run_id : Optional [str ] = None
6963 """The ID of the scenario run.
@@ -121,7 +115,7 @@ class InProgressRunAgentConfigExternalAPIAgentConfig(BaseModel):
121115
122116
123117class InProgressRunAgentConfigJobAgentConfigAgentEnvironment (BaseModel ):
124- """Environment configuration to use for this agent"""
118+ """Environment configuration for an agent in a benchmark job """
125119
126120 environment_variables : Optional [Dict [str , str ]] = None
127121 """Environment variables to set when launching the agent."""
@@ -142,7 +136,7 @@ class InProgressRunAgentConfigJobAgentConfig(BaseModel):
142136 type : Literal ["job_agent" ]
143137
144138 agent_environment : Optional [InProgressRunAgentConfigJobAgentConfigAgentEnvironment ] = None
145- """Environment configuration to use for this agent"""
139+ """Environment configuration for an agent in a benchmark job """
146140
147141 agent_id : Optional [str ] = None
148142 """ID of the agent to use (optional if agent exists by name)"""
@@ -225,7 +219,7 @@ class JobSourceScenariosJobSource(BaseModel):
225219
226220
227221class JobSpecAgentConfigAgentEnvironment (BaseModel ):
228- """Environment configuration to use for this agent"""
222+ """Environment configuration for an agent in a benchmark job """
229223
230224 environment_variables : Optional [Dict [str , str ]] = None
231225 """Environment variables to set when launching the agent."""
@@ -246,7 +240,7 @@ class JobSpecAgentConfig(BaseModel):
246240 type : Literal ["job_agent" ]
247241
248242 agent_environment : Optional [JobSpecAgentConfigAgentEnvironment ] = None
249- """Environment configuration to use for this agent"""
243+ """Environment configuration for an agent in a benchmark job """
250244
251245 agent_id : Optional [str ] = None
252246 """ID of the agent to use (optional if agent exists by name)"""
@@ -262,7 +256,7 @@ class JobSpecAgentConfig(BaseModel):
262256
263257
264258class JobSpecOrchestratorConfig (BaseModel ):
265- """Orchestrator configuration"""
259+ """Orchestrator configuration for benchmark job execution """
266260
267261 n_attempts : Optional [int ] = None
268262 """Number of retry attempts on failure (default: 0).
@@ -287,10 +281,7 @@ class JobSpecOrchestratorConfig(BaseModel):
287281
288282
289283class JobSpec (BaseModel ):
290- """The resolved job specification.
291-
292- Contains scenarios, agents, and orchestrator config.
293- """
284+ """Job specification describing scenarios and execution configuration"""
294285
295286 agent_configs : List [JobSpecAgentConfig ]
296287 """Agent configurations for this job"""
@@ -299,7 +290,7 @@ class JobSpec(BaseModel):
299290 """List of scenario IDs to execute"""
300291
301292 orchestrator_config : Optional [JobSpecOrchestratorConfig ] = None
302- """Orchestrator configuration"""
293+ """Orchestrator configuration for benchmark job execution """
303294
304295
305296class BenchmarkJobView (BaseModel ):
@@ -341,7 +332,4 @@ class BenchmarkJobView(BaseModel):
341332 """
342333
343334 job_spec : Optional [JobSpec ] = None
344- """The resolved job specification.
345-
346- Contains scenarios, agents, and orchestrator config.
347- """
335+ """Job specification describing scenarios and execution configuration"""
0 commit comments