List Simulations
list_simulationsRead-onlyIdempotent
Retrieve a list of past simulation runs with names, IDs, timestamps, and status. Filter by target or scenario, and choose summary or detailed metrics.
Instructions
List past simulation runs in the project.
Returns simulation run names, IDs, timestamps, and status, sorted by
most recent first. Defaults to the 10 most recent runs in summary mode.
Use detail_level="detailed" to include model_metrics and additional
fields (limit is capped to 5 in detailed mode to prevent overflow).
Use get_test_run_results with the returned test_run_id to retrieve
per-row scores (transcripts excluded by default). Then use
get_conversation_transcript with a scenario_index to inspect
individual conversation transcripts.
Args:
target_name: Optional filter — only show simulation runs using
this target.
scenario_name: Optional filter — only show simulation runs using
this scenario.
limit: Maximum number of runs to return, sorted by most recent
first. Defaults to 10. Set to 0 to return all runs.
detail_level: "summary" (default) returns compact results without
model_metrics. "detailed" returns full results with metrics
(limit capped to 5).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| target_name | No | ||
| detail_level | No | summary | |
| scenario_name | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |