Skip to main content

Table of Contents

Updating Next-Best-Action Designer version 2 to support multilevel configurations


Only available versions of this content are shown in the dropdown

If you already used Next-Best-Action Designer version 2 in versions of Pega Customer Decision Hub earlier than 8.5, after upgrading to Pega Customer Decision Hub 8.5, you must update your Next-Best-Action Designer configuration to support multilevel decisioning.

When planning the update, consider the various environments that you may have in your pipeline. First do the update in a single environment, in a dedicated, unlocked upgrade ruleset version, and then migrate all the rule changes to other environments in the pipeline.

  1. Ensure that no next-best-action outbound runs are active at moment and that no runs are planned for the same time frame as the Next-Best-Action Designer upgrade.

    The upgrade can take 30-45 minutes.
  2. Ensure that no inbound requests, such as real-time event and real-time container requests, are planned for the same time frame as the Next-Best-Action Designer upgrade.

  3. Ensure that the Context Dictionary configuration is saved and valid.

  4. Ensure that the ruleset and version used by your access group are unlocked, or create an unlocked version of the ruleset. By default, the ruleset used to store the configuration is Artifacts.

  5. Optional:

    Check in all checked-out artifacts related to Next-Best-Action Designer to avoid potential issues during the upgrade.

  6. Optional:

    Lock and roll the Artifacts ruleset version. For more information, see

  7. Click Update now.

After the update, when viewing an engagement policy in Next-Best-Action Designer, you may see a message stating that the backing strategy has been updated manually, as in the following figure:
Example engagement policy message
Example engagement policy message

The message does not indicate an error and can be safely ignored. To remove the message, you can edit the engagement policy and save it without making any changes.

Did you find this content helpful?

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us