Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, enabling users to interact programmatically with a wide range of Dataiku DSS resources and operations. Specifically, for the Machine Learning - Lab resource and the Get Model Snippet operation, the node retrieves short summary snippets of trained models associated with a particular ML task within an analysis in a project.

Common scenarios where this node is beneficial include:

  • Automating retrieval of model summaries for reporting or monitoring purposes.
  • Integrating model metadata into workflows for further processing or decision-making.
  • Quickly accessing concise information about trained models without manual navigation in the Dataiku DSS interface.

Practical example:

  • A user wants to fetch brief descriptions or key details of all trained models related to a specific machine learning task in a project to display in a dashboard or trigger alerts based on model status.

Properties

Name Meaning
Project Key The unique identifier of the Dataiku DSS project containing the ML task and models.
Analysis ID The identifier of the analysis that contains the ML task.
ML Task ID The identifier of the machine learning task whose model snippets are to be retrieved.

These properties are required to specify the exact context (project, analysis, ML task) from which to get the model snippets.

Output

The output is a JSON array where each item corresponds to a snippet (short summary) of a trained model associated with the specified ML task. The structure of each snippet depends on the Dataiku DSS API response but generally includes key metadata and summary information about each model.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials: specifically, an API authentication token (user API key) and the DSS server URL.
  • The node expects these credentials to be configured in n8n under a generic "Dataiku DSS API" credential type.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the Dataiku DSS API credentials are properly set up in n8n.
  • Required Parameter Errors: The node validates required parameters such as Project Key, Analysis ID, and ML Task ID. Missing any of these will cause an error. Double-check that these inputs are correctly provided.
  • API Request Failures: Network issues, incorrect server URLs, or invalid API keys can cause request failures. Verify connectivity and credentials.
  • Unexpected Response Format: If the API response cannot be parsed as JSON, the node attempts to return raw text. This might indicate an issue with the API or unexpected data.

Links and References


This summary focuses on the Machine Learning - Lab resource and the Get Model Snippet operation as requested, describing the input properties, output, dependencies, and common troubleshooting points based on static code analysis of the node implementation.

Discussion