Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, enabling users to perform a wide range of operations on Dataiku DSS resources. Specifically for the Machine Learning - Saved Model resource and the Evaluate MLflow Model Version operation, it allows evaluating the performance of a specific version of an MLflow model stored as a saved model in a project on a particular dataset.

Typical use cases include:

  • Automating model evaluation workflows within Dataiku projects.
  • Triggering model performance assessments programmatically after training or deployment.
  • Integrating model evaluation results into broader data pipelines or dashboards.

For example, a user can specify a saved model ID and version ID along with evaluation parameters to run an evaluation job on a dataset, receiving back metrics or results that describe the model's predictive quality.

Properties

Name Meaning
Project Key The key identifier of the Dataiku project containing the saved model.
Save Model ID The unique identifier of the saved model to evaluate.
Version ID The specific version of the saved model to evaluate.
Request Body JSON object containing the evaluation request parameters, such as dataset details or options.

Output

The node outputs the response from the Dataiku DSS API call related to the evaluation of the MLflow model version. This output is provided in the json field of the node's output data and typically contains evaluation metrics, status, or detailed results of the model evaluation process.

If the API returns binary data (not typical for this operation), it would be prepared accordingly, but for this operation, the output is expected to be JSON-formatted evaluation results.

Dependencies

  • Requires valid credentials for the Dataiku DSS API, including the server URL and an API key.
  • The node uses HTTP requests to interact with the Dataiku DSS REST API.
  • Proper permissions on the Dataiku project and saved model are necessary to perform the evaluation.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing API credentials, ensure that the Dataiku DSS API credentials are configured correctly in n8n.
  • Required Parameter Errors: The node validates required parameters like Project Key, Save Model ID, and Version ID. Missing any of these will cause errors. Double-check that all required fields are filled.
  • API Request Failures: Network issues, incorrect URLs, or insufficient permissions may cause API call failures. Review the error message for details and verify connectivity and access rights.
  • Invalid JSON in Request Body: The Request Body must be valid JSON. Malformed JSON will cause parsing errors.

Links and References


This summary focuses on the "Machine Learning - Saved Model" resource and the "Evaluate MLflow Model Version" operation as requested, based on static analysis of the provided source code and property definitions.

Discussion