Intro to ML

Our APIs have Machine Learning (ML) capabilities baked into them. If you’re using our Building Blocks, you’re collecting data in a way that is already plugged into our ML tool set. These docs will explain what you can do with our ML tools and how to do it.

We have two main types of ML models, recommendations and similarities. We’re continuously working on expanding that list. All ML models described in these docs are different, but share a set of common features and parameters.

Once you’re plugged into our APIs, you have access to several out-of-the-box recommenders and similarity models that apply to the most common use cases in our Simple ML section

For more flexibility and more detailed description of , check out the Advanced ML section.

In general, you will go through the following three phases for all ML models:

  1. Create the model on the dashboard. We automatically train and deploy it.

    1. The model can be retrained manually on the dashboard later on when more data is collected.

    2. An automatic evaluation that shows the validity of the model is created while the model is trained. This indicates how predictive the results should be.

  2. Query the recommendations or predictions online.

In order for you to be able to train models, you have to have some transaction history, e.g. users, products, orders and payments, on our platform.

If you have no or a low amount of orders, you will see the INSUFFICENT_DATA training status

Machine Learning Model object

Attributes

Type

Description

model_name

string

The name of the model.

model_type

string

The model type.

description

string

The model description.

features

array

An array of strings with features.

target

string

What is used to query with.

output_type

string

The result of the query.

training_status

string

A string with the training status. Possible values: STARTING, CREATED, TRAINING, PENDING, READY, RUNNABLE, FAILED, SUCCEEDED, INSUFFICIENT_DATA. Default is CREATED.

versions

array

List of objects with model versions.

current_version

object

Contains the id of the current live version

live

boolean

Default is False.