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 directly from n8n workflows. Specifically, for the Machine Learning - Lab resource and the Generate Model Documentation From File Template operation, it starts the generation of model documentation using a template file stored in a managed folder within a Dataiku project.

This functionality is beneficial when you want to automate the creation of detailed model documentation based on predefined templates, ensuring consistency and saving manual effort. For example, after training a machine learning model in Dataiku DSS, you can trigger this node to generate comprehensive documentation automatically, which can then be shared or archived.

Properties

Name Meaning
Project Key The unique identifier of the Dataiku project containing the model and template files.
Analysis ID Identifier of the specific analysis within the project related to the ML task.
ML Task ID Identifier of the machine learning task associated with the model.
Model Full ID The full identifier of the trained model for which documentation will be generated.
Query Parameters Optional key-value pairs appended as URL query parameters to customize the request.

Output

The node outputs JSON data representing the response from the Dataiku DSS API after initiating the model documentation generation process. This typically includes status information about the generation job or any metadata returned by the API.

If the operation involves downloading files (not applicable here), the node would output binary data representing the downloaded content.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Needs valid API credentials (an API key) for authentication with the Dataiku DSS API.
  • The Dataiku DSS server URL and user API key must be configured in the node credentials.
  • The specified project, analysis, ML task, and model must exist in the Dataiku DSS instance.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing API credentials, ensure that the Dataiku DSS API credentials are properly set up in n8n.
  • Required Parameter Missing: Errors indicating missing parameters like "Project Key", "Analysis ID", "ML Task ID", or "Model Full ID" mean these inputs were not provided but are mandatory for this operation.
  • API Request Failures: Network issues, incorrect server URLs, or invalid API keys can cause request failures. Verify connectivity and credential validity.
  • Invalid Model or Template IDs: Ensure that the model and template identifiers correspond to existing entities in the Dataiku project.
  • Permission Issues: The API key used must have sufficient permissions to access the project and perform documentation generation.

Links and References


This summary focuses on the Machine Learning - Lab resource and the Generate Model Documentation From File Template operation, describing its purpose, required inputs, expected outputs, dependencies, and common troubleshooting tips.

Discussion