The Pega-DecisionEngine agents support Decision Management operations.
The Pega Platform keeps a local cache of scoring models. Scoring model updates are regularly retrieved from the adaptive data store. The model update frequency is implemented by periodically triggering the UpdateAdaptiveModels agent (Pega-DecisionEngine ruleset, PRPC:Administrators access group). The agent runs the pxUpdateModels activity to retrieve model updates.
By default, the agent is scheduled to run every 30 seconds. The agent only retrieves scoring models required for executing the strategy and the models that are different from those in the local cache. Configure model update frequency through the Services landing page.
Large scale simulations are enabled by performing strategy execution in batch across system nodes. The assignment, queuing and management of large scale simulations is governed by the ProcessBatchJob agent configuration. The agent is scheduled to run with a given regularity (in seconds) to trigger checking assignments in the [email protected] work queue.
If there are assignments, they will be queued to create threads based on the thread configuration for each node. The status of the work item is updated as it progresses in this process and you can monitor the assignment by viewing the instances in the work queue. How many threads can be run in a given node is something that you define in the Topology landing page. You need to have the ProcessBatchJob agent configured in your ruleset to make use of this functionality.
Proposition cache works on a single Pega Platform node. When the Pega Platform runs on multiple system nodes connected to the same database, Decision Management uses the system pulse to ensure the consistency of propositions across all nodes. The proposition cache is invalidated when a proposition is saved (triggered by adding or changing a proposition) or deleted.
Adding records that result in the proposition cache becoming invalid is done through two declare trigger rules that run the pyRefreshPropositions activity (pyPropositionSaved and pyPropositionRemoved in Data-pxStrategyResult).
If your installation consists of different Pega Platform nodes connecting to the same database, enable the proposition cache synchronization mechanism by adding the PRPC:Administrators access group to the Pega-RULES: Core Engine Processing Agent data instance for every active node.
Adaptive Decision Manager can capture historical data for reporting purposes. The ADM Data Mart is implemented by periodically triggering the ADMSnapshot agent (Pega-DecisionEngine ruleset, PRPC:Administrators access group).
The agent runs the pzGetAllModelDetails activity. This activity captures the state of models, predictors, and predictor binning in the ADM system at a particular point in time and writes that information to a table using the Data-Decision-ADM-ModelSnapshot and Data-Decision-ADM-PredictiveBinningSnapshot classes. The Data-Decision-ADM-ModelSnapshot class is mapped to the PR_DATA_DM_ADMMART_MDL_FACT table and the Data-Decision-ADM-PredictiveBinningSnapshot class is mapped to the PR_DATA_DM_ADMMART_PRED_FACT table in PegaDATA database.
By default, the agent is scheduled to run every 120 seconds. The Data Mart settings in the Adaptive Decision Manager section of the Services landing page allow you to define how often the activity runs to capture the state of models and predictor binning.
A feature toggle enables or disables particular decisioning functionality through a corresponding instance of the Dynamic System Settings rule. A Dynamic System Setting corresponding to a particular feature toggle has the following format features/<featurename> and can be set to true or false.
The InitializeDSMFeatureToggles agent (Pega-DecisionEngine ruleset, PRPC:Administrators access group) runs at the Pega Platform startup and caches feature toggles in an object called FeatureManager. The feature toggles with their Dynamic System Setting set to true are initialized at the Pega Platform startup and enable particular functionalities of the platform.
The InitializeDSMFeatureToggles agent and the pzInitializeFeatureToggles activity that the agent references must not be modified.
The StartDSMServices agent (Pega-DecisionEngine ruleset, PRPC:Administrators access group) runs at the Pega Platform startup and makes the Pega 7 service manager to start all the nodes that are assigned to the Decision Management services (Decision Data Store, Adaptive Decision Manager, Data Flow, Visual Business Director).
The StartDSMServices agent and the pzStartDSMServices activity that the agent references must not be modified.