Skip to main content

CloudMLPredictIcon (2)63bd.png Machine Learning Predict

Use the Machine Learning Predict tool to use models you've built in Alteryx Machine Learning to make predictions about new data.

Important

The Machine Learning Predict tool requires the AMP engine to run. Note that AMP is the default engine for all new workflows starting with Designer 22.1. Learn more about the AMP engine.

Install the Tool

Important

If you’ve previously installed the Machine Learning Integration tools, you should first update to the 2023.2.0 version before you install the 2024.1 version. Even if you’ve already installed Designer 2024.1. Note that you don’t need to uninstall previous versions before installing a new version.

To install the Machine Learning Predict tool in Designer...

  1. Go to the downloads page.

  2. Go to Alteryx Intelligence Suite > Alteryx Intelligence Suite (your Designer version).

    1. Note that you must have Designer 24.1 or higher installed.

  3. Download the Alteryx Machine Learning Designer Integration Tools YXI file.

  4. Open Designer with the "Run as Administrator" option enabled.

  5. Open the YXI file to start the installation process.

    1. Note that the Machine Learning Predict tool appears in the Machine Learning tool palette.

Important

The integration tools are separate from the tools included in Alteryx Intelligence Suite.

Configure the Tool

Tool Version Selection

If you have multiple versions of the Machine Learning Integration tools installed, you can select which version you want to use in your workflow.

  1. Add a Machine Learning Integration tool to your workflow.

  2. Right-click the tool and then select the tool version you want to use from the Choose Tool Version menu.

If you don’t make a selection, the tool defaults to the most recent version.

Connect to Alteryx Machine Learning (OAuth)

For first time setup of the Machine Learning Integration tools, you must add your Alteryx Analytics Cloud (AAC) workspace as a Data Source…

  1. Add a Machine Learning Integration tool to your workflow.

  2. From the tool Configuration window, select Set Up a Connection to open the Data Connection Manager (DCM).

  3. On the Data Sources page, select New.

  4. Enter a Data Source Name that describes your AAC workspace.

  5. Enter the Base URL of your AAC workspace. For example, https://us1.alteryxcloud.com/.

  6. Enter your AAC Workspace Name.

  7. Select Save.

  8. From the Connections section, select Connect Credential.

  9. Leave OIDC as the Authentication Method.

  10. From the Credential dropdown, select your authorization credential.

    1. If you don’t have an authorization credential, select Create New Credential.

    2. Enter a Credential Name. For example, the name of your AAC workspace.

  11. Select the Allow connection for SDK checkbox.

  12. Select Link if you’ve used the Credential before, or select Create and Link if you just created it.

  13. Select Connect. Designer directs you to sign in to your AAC workspace.

If you already have a Data Source configured…

  1. Add a Machine Learning Integration tool to your workflow.

  2. From the tool Configuration window, select Set Up a Connection to open the Data Connection Manager (DCM).

  3. On the Data Sources page, select the Data Source you set up previously.

  4. Select Connect. Designer directs you to sign in to your AAC workspace.

Modeling Selection

  1. Prepare your new data for model prediction.

    1. Make sure to remove the target variable from your dataset.

    2. Match column names and data types to the dataset used to train your model.

  2. From the Machine Learning Predict tool, select the model you want to apply to your new data by selecting your Project.

    1. The Project Details, Model Details, and Ranking Metrics are all filled in from the model you've built in Alteryx Machine Learning.

  3. Select Run to apply the model to your new data.

  4. The Machine Learning Predict tool creates new columns of data in the output, which contain predictions.

Note

To avoid type warnings in your workflow, use a typing tool like the Select tool or Auto Field tool to change the column type. You can also manually fix type warnings.

In this section: