{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"To create a simulation run, send a POST request to `/v2/gen-ai/simulation_runs`. The scenario set must be ready. Judge and user simulator models are optional and use platform defaults when omitted. The run is returned in the pending state.","properties":{"body":{"$ref":"#/definitions/apiCreateSimulationRunInputPublic"}},"required":[],"additionalProperties":false,"definitions":{"apiCreateSimulationRunInputPublic":{"description":"Public parameters for creating a simulation run.","properties":{"agent_config":{"$ref":"#/definitions/apiCandidateAgentConfig"},"evaluation_config":{"$ref":"#/definitions/apiSimulationEvaluationConfig"},"exploration_budget":{"description":"Optional run-level episodes-per-scenario override. When set, overrides each scenario's exploration_budget.","type":"integer","examples":[123]},"judge_model_uuid":{"description":"Optional model override for the judge. Platform default when unset.","type":"string","examples":["123e4567-e89b-12d3-a456-426614174000"]},"max_turns":{"description":"Optional run-level turn budget. When set, overrides each scenario's max_turns.","type":"integer","examples":[123]},"name":{"description":"Optional run name.","type":"string","examples":["example name"]},"scenario_set_uuid":{"description":"UUID of the existing scenario set to execute. The set must be ready.","type":"string","examples":["123e4567-e89b-12d3-a456-426614174000"]},"user_simulator_config":{"description":"Optional user simulator model settings such as temperature and max_tokens.","type":"object"},"user_simulator_model_uuid":{"description":"Optional model override for the user simulator. Platform default when unset.","type":"string","examples":["123e4567-e89b-12d3-a456-426614174000"]}},"type":"object"},"apiCandidateAgentConfig":{"description":"Configuration of the candidate agent under test for a simulation run.","properties":{"agent_deployment_uuid":{"description":"Optional agent deployment to run. Defaults to the agent's current deployment when unset.","type":"string","examples":["123e4567-e89b-12d3-a456-426614174000"]},"agent_uuid":{"description":"UUID of the agent to exercise as the candidate.","type":"string","examples":["123e4567-e89b-12d3-a456-426614174000"]},"name":{"description":"Display name of the candidate agent. Persisted with the run.","type":"string","examples":["example name"]}},"type":"object"},"apiSimulationEvaluationConfig":{"description":"Optional configuration that opts a simulation run into an evaluation. When\nincluded on the create-run request, the platform reserves a\nmodel_evaluation_run linked to this simulation run and dispatches the\nevaluation automatically after the simulation finishes. The evaluation\nreuses the simulation run's judge_model_uuid.","properties":{"metric_uuids":{"description":"Evaluation metric UUIDs (from the evaluation metrics catalog). Must be\nsimulation-eligible (multi-turn) metrics; the create request is rejected\nif any UUID is unknown or ineligible.","items":{"type":"string","examples":["example string"]},"type":"array","examples":[["example string"]]},"star_metric":{"$ref":"#/definitions/apiStarMetric"}},"type":"object"},"apiStarMetric":{"properties":{"metric_uuid":{"type":"string","examples":["123e4567-e89b-12d3-a456-426614174000"]},"name":{"type":"string","examples":["example name"]},"success_threshold":{"description":"The success threshold for the star metric.\nThis is a value that the metric must reach to be considered successful.","type":"number","examples":[123]},"success_threshold_pct":{"description":"The success threshold for the star metric.\nThis is a percentage value between 0 and 100.","type":"integer","examples":[123]}},"type":"object"}}},"name":"Create Simulation Run","id":"digitalocean.genai_create_simulation_run","example":{},"maxRequests":1,"summary":false}}