Load a model file and instantiate the appropriate SHAP explainer.

Note: Prompt the user to provide local filesystem paths on their machine, public URLs, or upload via http://localhost:8765/ui/. Files attached directly in chat are stored in a cloud container (/mnt/user-data/) that local tools cannot reach.

Parameters

model_path : str | None Path to a local .joblib or .pkl model file. model_url : str | None Public URL to download a model file. model_type : str One of 'tree', 'linear', 'deep', 'kernel'. Default is 'tree'. background_path : str | None Path to background CSV dataset (optional for tree/kernel, required for deep).

Run SHAP explainer against a dataset.

Note: Ask the user for local file paths, public URLs (data_url), or use the Web GUI at http://localhost:8765/ui/. For small CSVs (< 500 rows), you may read the table from chat and pass the rows directly in data.

Parameters

data_path : str | None Path to a local CSV file. data_url : str | None Public URL to download a CSV dataset file. data : list[dict] | None Inline dataset passed as a JSON array. sample_size : int | None Override default auto-cap for dataset row sampling.

Return global feature importance from stored SHAP values.

Parameters

top_n : int Number of top features to return (default: 10).

Return SHAP breakdown for a single instance.

Parameters

index : int | None Row index in the analyzed dataset. data : dict[str, Any] | None Inline feature dictionary for explaining an arbitrary instance.

Return SHAP interaction values between two features (Tree models only).

Parameters

feature_a : str Name of the first feature. feature_b : str Name of the second feature.

Generate a SHAP visualization, save it as a PNG file, and return file path and URL.

Parameters

plot_type : str One of 'summary', 'bar', 'waterfall', 'force', 'dependence', 'heatmap'. index : int | None Row index in dataset (required for waterfall and force). feature_name : str | None Feature name (required for dependence). top_n : int Max features to show (default: 10). color_feature : str | None Feature to color by for dependence plots. output_path : str | None Override default output directory path.