.. _auto_ml_simlytiks_terminal:

*LEARNS AND PREDICTS THE COMMANDS FOR SIMLYTIKS BASED ON DATA*
==============================================================

Trains or runs inference on a natural-language-to-Simlytiks-command model hosted on a d3VIEW Terminal Server. In "learn" mode it submits a dataset schema and visualization definitions to build a new model, returning a unique model UID; in "predict" mode it sends a free-text query against a previously trained model and returns the predicted Simlytiks command as JSON.

When to use
-----------

Tagged: ``chatAPI``, ``command-prediction``, ``d3view``, ``nlp``, ``predict``, ``simlytiks``, ``terminal``, ``train``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Server URL
     - server_url
     - text
     - http://10.1.10.63:8502/
     - ✓
     - Base URL of the d3VIEW Terminal Server hosting the /chatAPI endpoints (e.g. http://10.1.10.63:8502/); trailing slash is stripped automatically.
   * - Dataset
     - dataset
     - dataset
     - —
     - ✓
     - Input dataset wired into the workflow context; used to provide data lineage but the worker primarily acts on the schema input during training.
   * - Schema
     - schema
     - dataset
     - —
     - ✓
     - Dataset containing column/schema metadata for the training data; passed as the 'dataset' payload to the /chatAPI/train endpoint in learn mode.
   * - Visualizations
     - visualizations
     - json
     - —
     - 
     - JSON file describing the visualization definitions (charts, plots) associated with the dataset; its 'payload' field is forwarded to the training endpoint as 'viz'.
   * - Learn Or Predict
     - type
     - select
     - learn
     - ✓
     - Mode selector: choose 'learn' to train a new model from the schema and visualizations, or 'predict' to query an existing model by UID; defaults to 'learn'.
   * - UID
     - uid
     - text
     - —
     - 
     - Unique model identifier returned from a previous 'learn' run; required when type is 'predict' to target the correct trained model.
   * - Predict Query
     - query
     - textarea
     - —
     - 
     - Free-text natural-language query (e.g. 'plot velocity vs time') submitted to the Terminal Server in 'predict' mode to retrieve the corresponding Simlytiks command.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - UID
     - uid
     - text
     - In 'learn' mode, the unique identifier assigned to the newly trained model by the Terminal Server; in 'predict' mode, echoes back the input UID for traceability.
   * - Prediction
     - result
     - json
     - JSON payload returned by the /chatAPI/predict endpoint containing the predicted Simlytiks command and any associated metadata; populated only in 'predict' mode.

Disciplines
-----------

- ai_ml.domain_reasoning
- ai_ml.llm
- ai_ml.supervised.classification
- platform.integration

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>ml_simlytiks_terminal</code>. Schema hash: <code>64cac8e7daba</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>