Skip to main content

ML Pro Nodes Reference

XGENIA provides five specialized pro nodes for machine learning workflows. These are visual nodes you can place on the canvas and wire into your application logic.

Available Nodes​

NodePurpose
Auto ML AnalyzerAnalyze datasets for ML readiness
Auto ML TrainerTrain models with HuggingFace AutoTrain
Auto ML PredictorRun inference with HuggingFace models
Client Retention AnalyzerAnalyze customer churn and retention
Retention Action EngineGenerate action plans from retention analysis

Common Inputs​

All ML pro nodes share these common inputs:

PortTypeDescription
hfTokenStringYour HuggingFace API key
mlServerUrlStringML Coordinator server URL (default: http://localhost:3001)

Auto ML Analyzer​

Analyzes your data before training. Detects the problem type, suggests the best target and features, identifies data quality issues, and recommends the appropriate HuggingFace task type.

Key outputs: problemType, targetColumn, suggestedFeatures, hfTaskType, dataQualityIssues

Full details →

Auto ML Trainer​

Creates a HuggingFace AutoTrain project, uploads data, and starts training. Supports task types: text-classification, tabular-classification, tabular-regression, image-classification, llm-finetuning, and dreambooth.

Key outputs: hfProjectId, hfModelRepo, trainingMetrics, status

Full details →

Auto ML Predictor​

Runs inference using any HuggingFace model. Supports both serverless (free) and dedicated endpoint modes. Handles text, tabular, and image model responses.

Key outputs: prediction, confidence, rawResponse

Full details →

Client Retention Analyzer​

Specialized node for customer retention analysis. Sends customer data to the ML Coordinator, which identifies churn patterns, calculates churn rate, and finds risk factors ranked by significance.

Inputs​

PortTypeDescription
dataArrayCustomer data records
contextStringAdditional context for analysis
AnalyzeSignalTrigger analysis

Outputs​

PortTypeDescription
insightsObjectFull retention analysis
churnRateNumberPercentage of churned customers
riskFactorsArrayRisk factors ranked by significance
recommendationsArraySuggestions to reduce churn
errorStringError message

Retention Action Engine​

Takes the output from the Client Retention Analyzer and generates specific, actionable retention actions. Maps risk factors to intervention strategies based on semantic analysis of each factor.

Inputs​

PortTypeDescription
insightsObjectOutput from Client Retention Analyzer
riskFactorsArrayStructured risk factor objects
GenerateSignalTrigger action generation

Outputs​

PortTypeDescription
actionsArrayGenerated retention actions
actionPlanObjectStructured action plan with priorities
errorStringError message

Prerequisites​

All ML pro nodes require:

  1. HuggingFace API key — configured in Settings or passed via the hfToken port
  2. ML Coordinator server — running at the URL specified in mlServerUrl

See Setting Up HuggingFace for configuration details.