Intro
This article describes how to use the AI Services tiles in Magic ETL.
To learn how to use tiles in DataFlows, see Create a Magic ETL DataFlow.
AI Forecasting Tile
The AI Forecasting tile allows you to predict future data points based on patterns or trends in your data by leveraging Domo’s Forecasting Universal Model. After saving your forecast in an output DataSet, you can view the DataSet in Analyzer to visualize your forecast in a Forecasting Chart.
Access the AI Forecasting tile under AI Services in the Magic ETL interface.
After you connect your input DataSet to an AI Forecasting tile on the Magic ETL canvas, you can configure your model preferences.
Select the AI Forecasting tile to expand the tile editor. Complete the steps in the editor.
First, choose a model. You can select the Domo ETS Forecasting Univeral Model or the Domo ARIMA Forecasting Universal Model.
Learn more about models.
After choosing the model, complete the other steps in the tile editor. This table describes how.
Settings | Description | Recommendations |
|---|
Date Column | Select the date column that identifies the date interval corresponding to each row in your DataSet. Values in this column must be stored as a date or time-stamp data type and must also be at the daily, weekly, monthly, quarterly, or yearly granularity level. If you have selected a DataSource, all available data columns with date or time-stamp data types are listed. | — |
Value Column | Select the numeric column of data to forecast. Values in this column must be stored as an integer, floating decimal, or fixed decimal data type. If you have selected a DataSource, all available numeric data columns that are an integer, floating decimal, or fixed decimal data type are listed. | — |
Frequency | Select the time-frequency to forecast. | — |
Forecast Length | Select or input the number of time intervals you want to forecast. For example, if you select the Day option for the Frequency setting and want to receive a forecast for the next two weeks, enter 14 for the Forecast Length. The number you input should be an integer (whole number, no decimals) that is greater than or equal to 1. | — |
Seasonality Period | Input the number of seasonality periods you would like the forecast to take into consideration. The input should be an integer (whole number, no decimals) that is greater than or equal to one. Seasonality refers to a repeating pattern that occurs in your data at a fixed frequency (ex., every hour, day, week, or month). For example, if you have daily sales data and tend to observe higher sales on weekdays than weekends, your data exhibits weekly seasonality and should set your Seasonality Period to seven. | - Daily Data
- Weekly seasonality (a reoccurring pattern for every seven days): set your seasonality period to 7.
- Monthly seasonality (reoccurring pattern every thirty days): set your seasonality period to 30.
- Annual seasonality (reoccurring pattern every 365 days): set your seasonality period to 365.
- For no seasonality, set the period to 1.
- The seasonality period is set to 7 if the Frequency = Day.
- Weekly Data
- Weekly seasonality (a reoccurring pattern every four weeks): set your seasonality period to 4.
- Quarterly seasonality (a reoccurring pattern every thirteen weeks): set your seasonality period to 13.
- Annual seasonality (a reoccurring pattern every fifty-two weeks): set your seasonality period to 52.
- For no seasonality, set the period to 1.
- The seasonality period is set to 1 if the Frequency = Week.
- Monthly Data
- Quarterly seasonality (a reoccurring pattern every three months): set your seasonality period to 3.
- Annual seasonality (a reoccurring pattern every twelve months): set your seasonality period to 12.
- For no seasonality, set the period to 1.
- The seasonality period is set to 12 if the Frequency = Day.
- Quarterly Data
- Annual seasonality (a reoccurring pattern every four quarters): set the seasonality period to 4.
- For no seasonality, set the period to 1.
- The seasonality period is set to 4 if the Frequency = Quarterly.
- Yearly Data
- If your data exhibits a reoccurring pattern every X years (such as 1, 2, 3…, set the seasonality period to X.
- For no seasonality, set the period to one.
- The seasonality period is set to one if the Frequency = Yearly.
|
After configuring the AI Forecasting tile, finish configuring your Magic ETL DataFlow and create the output Dataset.
Note: The number of rows in your output DataSet depends on the number of data points you configured to be forecasted.
Column | Description | Example |
|---|
forecast_value | This column includes the forecasted values. | — |
confidence_0 | The type of confidence interval built. | 80% |
confidence_1 |
lower_0 | The lower range of your confidence interval. The columns depend on the associated confidence interval.
For example, lower_0 is the lower range for the confidence_0 interval. | — |
lower_1 |
upper_0 | The upper range of your confidence interval. The columns depend on the associated confidence interval.
For example, upper_0 is the upper range for the confidence_0 interval. | — |
upper_1 |
Interpret Results from the AI Forecasting Tile
You can interpret and explore the results of your forecast by opening the output DataSet in Analyzer. Use the chart type finder to choose a Forecasting Chart.
Use the upper and lower bound columns from your output DataSet to set your bounds and display the forecast confidence ranges.
Learn more about the Forecasting Chart.
AI Model Inference Tile
The AI Model Inference tile allows you to gather insights from your input DataSet and use the inferred output DataSet throughout Domo.
You can also use the output DataSet from your AI Model Inference tile to create App Studio apps and DataBricks that display data analysis, model performance, model predictions, and what-if analysis examples to share with other people in your organization.
Required Grant
To access the AI Model Inference tile in Magic ETL, the following grant must be enabled for your role:
- Use AI Services — Allows a user to access and use the AI Services in Domo.
For more information on grants, see Managing Custom Roles.
Configure the AI Model Inference Tile
Important: The Magic ETL Preview function doesn’t work with the AI Model Inference tile.
-
Select the DataSet you want to gather inferences from and open it in Magic ETL.
-
In the Magic ETL sidebar, expand Data Science and drag an AI Model Inference tile to the canvas.
-
Connect your input DataSet to the tile. You can only use one DataSet as input.
-
In the tile editor, choose Select a Model to search for and choose a model to use for your inference. The model schema must match the schema of the input DataSet. If the schemas do not match, an error message displays.
If the schema of your input DataSet matches the model’s schema, you can select the model you want to bring in. You can only use models with a CSV type in Magic ETL.
-
Depending on the model, you can select a task if multiple options are available in the Pick a Task dropdown. The model task automatically generates from your selected model. Models may have multiple tasks, but only one task is selected for the DataFlow. In the example used above, only the “Other” task type is available.
-
Select a tier, depending on the number of resources used to run the model. A tier is the size of the resources the model is running with and the number of central processing units (CPUs) used. Learn more about compute tiers.
-
(Optional) Check the box labeled Include Input Data in Output Data to duplicate all the rows from your input DataSet. This means that if you have 10 rows of data in your input, there will be 10 rows of data in your output.
If you leave the box unchecked, only the inferred data is included in the output DataSet.
Text Generation Tile (Beta)
Valuable information is often inaccessible inside text columns in your DataSets—and parsing, categorizing, and analyzing text can be manual and time-consuming. The Text Generation tile leverages Domo AI to translate and process text fields, allowing you to analyze and take advantage of your text data’s full value.
Required Grants
To access the Text Generation tile in Magic ETL, the following grants must be enabled for your role:
(Learn more about grants.)
- Execute AutoML
- Create AI Service Models
- Use AI Services
Important: You must also have AI Services enabled and the ability to create a DataFlow. Learn how to create a DataFlow. Configure the Text Generation Tile
Note: The Magic ETL Preview function doesn’t work with the Text Generation tile, due to the timeout of the AI model.
-
Open the Magic ETL canvas and choose an input DataSet that contains a text column you want to analyze.
Important: The DataSet you choose must have a MINIMUM of 100 rows. The tile will error if you have fewer than 100 rows, due to an AWS limitation.
-
Under AI Services in the left drawer, drag a Text Generation tile to the canvas.
The tile editor expands below the canvas.
-
In the tile editor, choose the AI model you want to use with the Text Generation tile.
-
Then choose the temperature of your desired response. Lower values provide more predictability, while higher values provide more creativity.
-
Provide the model with instructions on how to analyze the column. Be very specific; describe exactly what you want the model to do (and not to do).
Tip: Constructing a prompt that returns the results you need is a skill that takes time and practice.
-
Use the Insert Value dropdown to choose the column that contains the text to be analyzed. You can also provide more details about what should be done with the data.
After the Text Generation tile executes, it adds a column to your DataSet named Output. You can use tiles farther downstream in the DataFlow to rename that column.
Notes:
-
You can include multiple Text Generation tiles in the same DataFlow, tasking them with different aspects of analysis for the column (or analysis of different columns).
-
You can give multiple instructions in a single Text Generation tile, although you’ll need a way to parse the results of the multiple instructions from the single output column.
For example, you could instruct the model to separate the output of each instruction with a specific delimiter and then use the Split Columns action to parse.
Here’s an example of the output DataSet from a DataFlow leveraging multiple instances of the Text Generation tile to analyze language, translate the review to English, analyze sentiment, and categorize the review based on provided themes.
FAQ
Can I use my own model in the Text Generation tile?
Not currently, but this capability is on the roadmap.
Can you output multiple columns from a single Text Generation tile?
No, it outputs a single column. You can use multiple Text Generation tiles for multiple instructions. Alternatively, you can instruct the tile to respond to your instructions by a specific delimiter and then use other Magic ETL tiles downstream in your DataFlow to parse the responses into their own columns.
