run_simulation

readSeit v1.0

Führt die Simulation aus und liefert die BERECHNETEN Zeitreihen eines Szenarios zurück. Anders als get_time_series (das nur gespeicherte Eingabewerte zurückgibt — manuelle Eingaben oder Live-Daten) wertet dieses Tool die Rhai-Eigenschaftsformeln und Act-Skripte bei Bedarf aus und liefert die resultierenden Werte je Agent, Eigenschaft und Zeitschritt, jeweils mit der zugehörigen Simulationszeit, sowie Formel-Diagnosen. Nur so lassen sich formelbasierte Ergebnisse über die API lesen: Sie werden bei Bedarf berechnet und nicht gespeichert. scenario_id ist erforderlich; parameter_set_id verwendet standardmäßig den Standard-Parametersatz des Twins. Mit agent_instance_id, property_id, min_timestep und max_timestep lassen sich große Zeitreihen eingrenzen. Prüfen Sie das Feld diagnostics (Kompilierungs- und Laufzeitfehler von Formeln/Act-Skripten, Zyklen, ungelöste Abhängigkeiten), wenn Ergebnisse falsch oder leer erscheinen.

Beispielanfrage

{"scenario_id": "scenario-uuid", "agent_instance_id": "agent-uuid", "property_id": "inventory"}

Beispielantwort

{"scenario_id": "scenario-uuid", "parameter_set_id": "default", "total_count": 24, "returned_count": 24, "rows": [{"agent_instance_id": "agent-uuid", "property_id": "prop-uuid", "timestep_index": 0, "time": 1.0, "value": 600000.0}], "diagnostics": []}