Adding data to aito.ai happens with "Send to an API" activity. What ever the input to that activity will be, is to be sent one by one to API. In this case to aito.ai. Note! If you are working with bigger datasets, you should explore batch transfer options.
Check the below screenshots for guidance on how to set up the connection. Here are the steps.
- Request type is POST.
- API endpoint URL is the one given to you in console, along with
/api/v1/data/[tablename]where you need to add a name of the table in aito.ai to which you are uploading data.
- Body needs to be constructed to have a JSON element that contains the data that you are uploading. Check the example in the screenshot of using Parabola's merge tags to add data from your input.
- Max requests throttles the number of calls sent to API. Drop it to 30 per minute to avoid any issues.
- In authentication, you should add two custom headers. One is
application/jsonand the second is
x-api-keywith value being the read/write key that you find in aito.ai console.
There are two ways to make queries to aito.ai API from your Parabola workflow.
Pull from an API would work if you start by getting some data from aito.ai and push it to other activities later on.
Enrich with an API would be more typical way of using aito.ai in Parabola. It enriches your existing dataset by triggering a call for each row and adding something new there. For example predicting a missing datapoint for each row.
Below example pulls data from Google Sheet, enriches it with aito.ai, and then pushes back to another Google Sheet.
Click open the activity, and configure your action with aito.ai. Follow the numbering in the screenshots.
- 1.Choose the right HTTP request method in Type. Most of the times it is POST.
- 2.Endpoint URL is a combination of yoru instance URL (check from the aito.ai Console), and API endpoint in use. In this case we are using
_similarityas the endpoint.
- 3.Query body goes here. Essentially, you are writing an aito.ai predictive query. Remember that Parabola merge tags make it easy to feed in the data from the each row of your input.
- 4.Add custom header
Content-Typewith a value
- 5.Add another custom header, where the key is
x-api-keyand the value is the API key that you can fetch from the aito.ai Console.
- 6.This is really handy! Parabola will parse the response and pick up the right element if you choose "hits" as Top Level Key in the Nested Keys section. Note that in this case it is recommended to limit the query results to one with
"limit": 1in your query body. This way you'll get only the top prediction for each row.
Configurinng aito.ai query, part1
Configuring aito.ai query, part2