Checks that dashAI is running and summarizes what is loaded.

Call this FIRST when something fails or when you do not know whether the backend is up: it tells "dashAI is down" apart from "that id does not exist", which are two problems with different fixes.

Args: params (NoArgs): no parameters.

Returns: str: JSON with the following schema: { "base_url": str, # which instance is being targeted "reachable": bool, # whether it responded "datasets": int, # number of loaded datasets "runs": int, # number of recorded runs "queue_empty": bool # whether the job queue is empty } On failure: "Error: ".

Lists the datasets loaded in dashAI.

Returns only id, name, date and status — just enough to pick one. To see columns and types use dashai_describe_dataset with the id.

Args: params (ListDatasets): contains: - limit (int): maximum to return, 1-200 (default 50)

Returns: str: JSON {"count": int, "datasets": [{"id", "name", "created", "status"}]} If there are none: a message explaining how to load data from the GUI.

Returns everything needed to configure a training run over a dataset.

Gathers into a single call what the raw API splits into four (/{id}, /info, /types and /sample), because deciding which columns are input and which is output requires seeing them together.

Args: params (DescribeDataset): contains: - dataset_id (int): dataset id - include_sample (bool): include sample rows (default True)

Returns: str: JSON {"dataset": {...}, "info": {...}, "column_types": {...}, "sample": [...]} If one part is unavailable it comes back as null instead of failing whole.

Lists the registered components: models, metrics, tasks and optimizers.

ALWAYS use this before dashai_train_model. The names dashAI expects are exact and case-sensitive, and the catalogue changes with the plugins that instance has installed — they cannot be guessed.

Args: params (ListComponents): contains: - types (Optional[List[str]]): filter by 'Model', 'Metric', 'Task', 'Optimizer'

Returns: str: JSON {"count": int, "components": [{"name": str, "type": str, "schema": {...}}]} The schema field describes the hyperparameters that component accepts.

Trains a model on a dataset and returns the id of the enqueued job.

It does NOT wait for it to finish. Training can take minutes or hours, so dashAI enqueues it and this tool returns immediately; progress is polled with dashai_job_status.

Collapses the three calls the raw API demands:

1. POST /model-session/ creates the experiment (dataset, task, columns, metrics)

2. POST /run/ creates the run (model, hyperparameters)

3. POST /job/ enqueues the ModelJob

Args: params (TrainModel): contains: - dataset_id (int), task_name (str), model_name (str) - input_columns / output_columns (List[str]) - metrics (List[str]), goal_metric (str) - parameters (Dict): model hyperparameters - splits (Dict[str, float]): proportions adding up to 1.0 - optimizer_name (str), optimizer_parameters (Dict) - run_name (Optional[str])

Returns: str: JSON {"job_id": str, "run_id": int, "model_session_id": int, "status": "enqueued", "next_step": str} On failure: "Error: ..." stating which parameter dashAI rejected.

Examples: - "Train a random forest on dataset 3 predicting 'species'" - Do not use it to read results: that is dashai_get_run, with the run_id.

Polls the status of an enqueued job (training, prediction, explanation).

dashAI's statuses: not_started (queued), started (running), finished (done) and error (failed). Telling started from error matters: the first is worth waiting on, the second does not improve by polling again.

Args: params (JobStatus): contains: - job_id (str): id returned when enqueuing

Returns: str: JSON {"job_id": str, "status": str, "finished": bool, "failed": bool, "raw": {...}}

Lists the recorded training runs, with their status.

Useful for comparing models trained within the same experiment.

Args: params (ListRuns): contains: - model_session_id (Optional[int]): filter by experiment - limit (int): maximum to return, 1-200 (default 50)

Returns: str: JSON {"count": int, "runs": [{"id", "name", "model_name", "status", "goal_metric"}]}

Returns the configuration and metrics of a training run.

This is where results are read once dashai_job_status says finished. If the run did not finish, the metrics will come back empty — that is not an error.

Args: params (GetRun): contains: - run_id (int): run id

Returns: str: JSON with the full run: model parameters, status and metrics per split (train / validation / test).

Enqueues a prediction using the model of an already finished run.

Like training, it is asynchronous: it returns a job_id and the result is followed with dashai_job_status. The run must be in FINISHED status; if it is not, dashAI rejects the request.

Args: params (Predict): contains: - run_id (int): id of a finished run

Returns: str: JSON {"job_id": str, "run_id": int, "status": "enqueued", "next_step": str}