Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Importing a predictive model

Updated on July 5, 2022

Import predictive models from third-party tools to predict customer actions. You can import PMML and H2O models.

You can import models from both H2O-3 and H2O Driverless AI platforms. For a list of supported PMML and H2O models, see Supported models for import.

Before you begin: Download the model that you want to import to your local directory:
  • For PMML models, download the model in PMML format.
  • For H2O-3 models, download the model in .mojo format.
  • For H2O Driverless AI models, download and extract the MOJO Scoring Pipeline file as a .zip file.

If you want to import a model from the H2O Driverless AI platform, specify the Driverless AI license key and import the H2O implementation library. For more information, see Specifying the H2O Driverless AI license key and Importing the H2O implementation library.

  1. In the navigation pane of Prediction Studio, click Models.
  2. In the header of the Models work area, click NewPredictive model.
  3. In the New predictive model dialog box, enter a Name for your model.
  4. In the Create model section, click Import model.
  5. Click Choose file, and then select a model file to import.
    For Driverless AI models, in the mojo-pipeline folder, select the pipeline.mojo file.
  6. In the Context section, specify the model context:
    ChoicesActions
    Save your model in the default application contextSelect the Use default context check box.

    For more information, see Configuring the default rule context.

    Save your model in a custom context
    1. Click the Apply to class field, press the Down arrow key, and then select the class in which you want to save the model.
    2. Define the class context by selecting appropriate values from the Development branch, Add to ruleset, and Ruleset version lists.
  7. Verify the settings, and then click Next.
  8. Optional: To change the default label for the model objective, in the Outcome definition section, click Set labels, and then enter a meaningful name in the associated field.
    Note: To capture responses for the model, the model objective label that you specify should match the value of the .pyPrediction parameter in the response strategy (applies to all model types).
  9. In the Outcome definition section, specify what the model predicts:
    ScenariosActions
    You are importing a binary outcome model
    1. In the Monitor the probability of field, select the outcome that you want to predict.
    2. In the Advanced section, enter the expected score range.
    3. In the Classification output field, select one of the model outputs to classify the model.
    You are importing a continuous outcome model
    1. In the Predicting list, select A continuous value.
    2. In the Predicting values between fields, enter values for the range of outcomes that you want to predict.
    You are importing a categorical outcome modelIn the Predicting section, verify the categories to predict.
  10. Optional: To compare actual model performance against expected model performance, in the Expected performance field, enter a value that represents the expected predictive performance of the model.
    The performance measurement metrics are different for each model type. For more information, see Metrics for measuring predictive performance.
  11. Confirm the model settings by clicking Import.
  12. On the Mapping tab, associate the model predictors with Pega Platform properties.
    For more information, see Editing an imported model.
  • Specifying the H2O Driverless AI license key

    Import predictive models from the H2O Driverless AI platform by first providing your license key.

  • Importing the H2O implementation library

    Enable the import of predictive models from the H2O Driverless AI platform, by importing the H2O implementation library to Pega Platform.

  • Editing an imported model

    After importing a predictive model from a PMML file or an H2O MOJO file, map the model predictors to Pega Platform properties. You can also update the outcome definition settings.

  • Configuring custom functions of a PMML model

    PMML functions transform data in PMML models. These models include several predefined functions that are defined as Java code in the Pega PMML execution engine. Additionally, PMML producers sometimes use proprietary expressions (functions) with the PMML models that are not part of the models themselves. These functions are used for various reasons (such as performance increase or enhancements). In such cases, the PMML model contains custom functions (the model contains only references to the functions and their parameters).

  • XSD validation and PMML error messages

    When you upload a PMML file in the Predictive Model rule and want to save it, the file is parsed and checked for any syntactic errors. The contents of the PMML file is validated against the respective version of the XSD schema that is specified in the file. The following table lists the error that might occur.

  • Supported models for import

    Learn more about the PMML and H2O models that you can import to Prediction Studio.

  • Previous topic Template categories for creating predictive models
  • Next topic Specifying the H2O Driverless AI license key

Related articles

Setting access to Prediction StudioImporting a projectExporting a projectTemplate categories for creating predictive models

Tags

Pega Platform 8.7 Decision Management

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Visit the Support Center

Did you find this content helpful?

Yes
No

Want to help us improve this content?
Suggest an edit

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us