Alteryx ML multi-tenant integration with Alteryx Designer
So, you’ve recently been given access to Alteryx Machine Learning and would like to integrate with the rest of the Alteryx products like Alteryx Designer and Server.
First you’ll want to make sure that you have Alteryx Intelligence Suite installed or unlocked on your Alteryx Designer, you can find how to unlock Intelligence Suite here. If you have access to Alteryx Machine Learning you should also have an intelligence suite license assigned, your license administrator or account team should be able to provide you one if you don’t already have one.
The next steps, once you have intelligence suite is to install the integration tools for Alteryx Machine Learning.
Installing the integration tools
Logon to the Alteryx License Portal, you will find the tools under Intelligence Suite downloads.
![clopez_0-1679966598462.png clopez_0-1679966598462.png](https://community.alteryx.com/t5/image/serverpage/image-id/295604iC6596E4C21C25F72/image-size/medium?v=v2&px=400)
For version you will want to make sure that your Designer, Intelligence Suite, and ML integration tools all have the same version.
Note: The earliest supported version for the ML tools is 2021.3.
In this example we are using the latest version 2022.3
![clopez_1-1679966598591.png clopez_1-1679966598591.png](https://community.alteryx.com/t5/image/serverpage/image-id/295603i8893C16608D90EE2/image-size/medium?v=v2&px=400)
The integration tools come in a YXI file
![clopez_2-1679966598716.png clopez_2-1679966598716.png](https://community.alteryx.com/t5/image/serverpage/image-id/295602iF8727092E138346B/image-size/medium?v=v2&px=400)
Install the Integration Tools
The easiest way to run the installer is to open Alteryx Designer > File > Open Workflow > Browse > Find the installer and select Open. The installer will run and should be done in just a few seconds.
![clopez_3-1679966598768.png clopez_3-1679966598768.png](https://community.alteryx.com/t5/image/serverpage/image-id/295605iA878DEB9278914FE/image-size/medium?v=v2&px=400)
Once the installer runs, we recommend closing Designer and reopening it just to be on the safe side, but once it is open you will find two new tools in designer
1. Machine Learning Send
![clopez_4-1679966598870.png clopez_4-1679966598870.png](https://community.alteryx.com/t5/image/serverpage/image-id/295606i2021DF88A9CC17BA/image-size/medium?v=v2&px=400)
With this new tool you will be able to create new Alteryx ML projects or push new data to existing projects
- Machine Learning Predict
![clopez_5-1679966598981.png clopez_5-1679966598981.png](https://community.alteryx.com/t5/image/serverpage/image-id/295607iA61AB7CC5D0D2CFC/image-size/medium?v=v2&px=400)
With this tool you will be able to select an existing, completed project from Alteryx ML and use it to score new data. This tool can be used in both Designer and Server.
Connecting to Alteryx ML
You will notice that when you try to use either of the new tools that it will ask you for an SSO or Token connection, the tool is dynamic depending on your URL.
1. If your URL has the following pattern http://automl.[company name].alteryxcloud.com then you will need to use SSO to complete the integration.
- However, if your URL has the following pattern https://us1.alteryxcloud.com/cloud-portal/?workspace=[company name] then you will use an authorization token to complete the integration.
Getting an authorization token
Access your personal account settings to create a token. From anywhere in the UI click on the upper right side where your initials are and click on your name then select “Access Tokens”
![clopez_6-1679966599056.png clopez_6-1679966599056.png](https://community.alteryx.com/t5/image/serverpage/image-id/295608iD78D830C83D1E9F9/image-size/medium?v=v2&px=400)
Generate a new token for yourself and enter a description
![clopez_7-1679966599207.png clopez_7-1679966599207.png](https://community.alteryx.com/t5/image/serverpage/image-id/295610i82A8F890AFF61F19/image-size/medium?v=v2&px=400)
![clopez_8-1679966599327.png clopez_8-1679966599327.png](https://community.alteryx.com/t5/image/serverpage/image-id/295609iE6F6FBBDAAC13225/image-size/medium?v=v2&px=400)
Once you click Generate you will see a long string of numbers and characters, this is your token guard it and keep it safe as you would a very sensitive password, it will enable you to interact with Alteryx ML programmatically. It is also important to note that this will be displayed to you exactly once, after that initial retrieval it will never be displayed in the platform again.
![clopez_9-1679966599518.png clopez_9-1679966599518.png](https://community.alteryx.com/t5/image/serverpage/image-id/295613i4BF5D1CF1CBB12D9/image-size/medium?v=v2&px=400)
DCM Set Up
The first step to a successful integration is to ensure that DCM is properly set up and enabled, if you do not have DCM enabled yet, follow this quick guide, Alteryx has made it simple to do.
Next, open your connections manager to add a new data source and connection
![clopez_10-1679966599566.png clopez_10-1679966599566.png](https://community.alteryx.com/t5/image/serverpage/image-id/295611i96EEFD01D8196AC1/image-size/medium?v=v2&px=400)
Under Data Sources, add a new source
![clopez_11-1679966599598.png clopez_11-1679966599598.png](https://community.alteryx.com/t5/image/serverpage/image-id/295612i38313D4485510CF3/image-size/medium?v=v2&px=400)
The technology you will be using to set up the integration is “Trifacta Auth”
![clopez_12-1679966599633.png clopez_12-1679966599633.png](https://community.alteryx.com/t5/image/serverpage/image-id/295614i92A49A8832AEB9E1/image-size/medium?v=v2&px=400)
Note: If you do not see Trifacta Auth, ensure you have the latest version of the integration tools installed and restart Designer
Give your integration a name that is representative of what we are trying to achieve and save it
![clopez_13-1679966599670.png clopez_13-1679966599670.png](https://community.alteryx.com/t5/image/serverpage/image-id/295615i559205466A7589D6/image-size/medium?v=v2&px=400)
Next, click into the data source to edit it and click “Connect Credential”
![clopez_14-1679966599704.png clopez_14-1679966599704.png](https://community.alteryx.com/t5/image/serverpage/image-id/295616i9393D634F61F858E/image-size/medium?v=v2&px=400)
Then follow these steps
- Select Access Token as Authorization Method
- Under Trifacta Auth Credential select “Create New Credential”
- Give your credential a name that let’s others know what you’re doing
- Paste the Access Token you obtained from the platform portal
- Create and Link
![clopez_15-1679966599735.png clopez_15-1679966599735.png](https://community.alteryx.com/t5/image/serverpage/image-id/295617i0EF9526EEEFBD7FD/image-size/medium?v=v2&px=400)
That is it, you’re done!
To test out the integration bring in a small dataset into the canvas and use the integration tools to create a new project and send data to it
Under the URL enter this address exactly: https://us1.alteryxcloud.com/automl
![clopez_16-1679966599782.png clopez_16-1679966599782.png](https://community.alteryx.com/t5/image/serverpage/image-id/295619i9B45730F802650F1/image-size/medium?v=v2&px=400)
Once you click Sign In DCM will pop up, click on the connection we set up earlier
![clopez_17-1679966599827.png clopez_17-1679966599827.png](https://community.alteryx.com/t5/image/serverpage/image-id/295618i722942E5CE7C069E/image-size/medium?v=v2&px=400)
Finally run your workflow and verify that the new project and data have landed on the ML platform
![clopez_18-1679966599873.png clopez_18-1679966599873.png](https://community.alteryx.com/t5/image/serverpage/image-id/295620iA298088FEE1ACF93/image-size/medium?v=v2&px=400)
![clopez_19-1679966599908.png clopez_19-1679966599908.png](https://community.alteryx.com/t5/image/serverpage/image-id/295621i79BBBC729CA378DB/image-size/medium?v=v2&px=400)
For the Machine Learning Score tool you will follow the same steps as shown above, but you do not need to create a new connection for it, just log in using the same token!