Skip to main content


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

Configuring Intelligent Virtual Assistant

Updated on November 25, 2021

Use the Pega Intelligent Virtual Assistant for Pega Sales Automation Outlook add-in to improve email productivity. The Outlook add-in uses natural language processing (NLP) to analyze email content and suggest tasks and email responses to sales representatives.

Pega Sales Automation Implementation Guide Pega Sales Automation Implementation Guide Pega Sales Automation Implementation Guide Pega Sales Automation Implementation Guide Pega Sales Automation Implementation Guide
Each email that a sales rep opens has real-time match scores attributed to it, and suggested next actions and tasks appear directly in Outlook, within a built-in dashboard. The sales rep's actions become the baseline for training of the NLP models, increasing the accuracy of suggestions over time. Pega sentiment analysis also determines whether content of an incoming email is positive, negative, or neutral.

Configure the NLP for Outlook add-in by performing the procedures in this section.

Enabling NLP suggestions for email

To configure the NLP analysis for email in your application, enable NLP suggestions.

  1. In the User portal, from the Explorer panel, select Administration.
  2. Go to Microsoft Integration, and select the Enable suggestions using NLP checkbox.
  3. Click on Save.
  4. In the navigation pane of Dev Studio, click App, and then search for and open the Data-Channel-Email class.
  5. Create an email channel by performing the following steps:
    1. In the header of Dev Studio, click your application name, and then click Channels and interfaces.
    2. In the Create new channel interface section, click Email.
    3. Add and configure your channel:
      1. On the Configuration tab, in the Email channel name field, enter a name for the email channel that you want to create.
      2. Optional: In the Description field, enter a description for the channel.
      3. On the Behavior tab, in the Text Analyzer field, select the Record training data and Enable subject analysis check boxes.
    4. Click Save.
      When you save the channel, the system creates the default text analyzer with your channel configuration.
  6. In the top-right corner, click ActionsView XML, and then search for the pzInsKey value.
  7. Copy the pzInsKey value.
  8. In the header of Dev Studio, click RecordsSysAdminDynamic System Settings, and then search for and select the EmailChannelHandle dynamic system setting.
  9. In Value field, paste the pzInsKey contents, and then click Save.

Editing the text analyzer rule

After configuring the channel, associate topics with reply templates.

  1. In the header of Dev Studio, click the name of your application, and then click Channels and interfaces and open your email channel.
    Note: For the steps below, use the PegaSalesAutomation1a443529ec5e46c991b0565447a7b812 text analyzer rule as an example.
  2. On the Behavior tab, in the Text Analyzer section, click Open the text analyzer rule.
  3. Configure your text analyzer:
    1. On the Select Analysis tab, in the Text categorization section, in the Topic model field, add the topic model of your text analyzer.
    2. In the Topic preference section, choose one of the following options:
    • For new models, select the Always user rule based topics radio button.
    • For models that you have already trained, select the Use Model based topics if available radio button.
    1. Ensure that the Enable intent detection check box is cleared.
  4. Click Save.
Result: When the system runs NLP on an email or message, training data is submitted for a review. You can add the training data to the model based on your business context. For more information, see Train entity models with a single click.

Optional: Configuring custom cases

Pega Sales Automation features a Create task case that you can edit and use. To implement NLP suggestions for your business cases, review the suggested custom configuration steps for cases.

  1. In the header of Dev Studio, search for and select the OutlookSuggestCase section to view the suggested cases and a configuration example.
  2. To map entities, drag the parameters to the Create Work action.
    1. Click View properties next to the cell that you want to modify.
    2. On the Actions tab, drag the parameters to the Create Work action.
  3. To further configure the Create Work action, choose any of the following actions:
    • To support the NLP feedback mechanism, select AssociatedID as one of the parameters.
    • To Support NLP suggestions for cases other than the Create task case, in the header of Dev Studio, search for and select the 8.2 compatible with Outlook crmNewHarnessButtons_Mobile section.
    • To configure the Discard button, click View properties, and then on the Actions tab, add the RemovedFeedbackDataOnCancel data transform.
    • To configure the Create task button, click View properties, and then on the Actions tab, add the SetFeedbackForNLP data transform.
    • To review all of the detected entities, open the D_NLPEntities.pyExtractedEntities page group.
    • To customize your implementation, use the D_GetSpecificEntities.pyExtractedEntities page group and GetSpecificEntitiesAsExt activity as an example extension.
  4. Click Submit.

Optional: Configuring custom replies

Pega Sales Automation also has Defuse, Competitor, and Product reply templates that you can edit and use. To implement NLP suggestions for your custom replies, review the suggested custom configuration.

Note: Suggested replies sections apply only to the iOS and Android Mobile Outlook clients. User-created emails and appointments or selected appointments and meeting-related items do not support NLP suggestions by default. By default, the reply templates are configured for external users. If you leave a template with a blank value or select an incorrect value, both internal and external users can access it.

  1. In the header of Dev Studio, open the PopulateSuggestedReplies data transform to view the suggested reply configuration and extension points.
  2. Optional: To customize the content of reply templates based on competitors or products, use the D_NLPEntities or SelectedWorkPage data pages to find entities.
  3. In the header of Dev Studio, search for and select the SuggestedRepliesWithUserType map value rule, and then edit it by configuring your suggested replies templates as either internal or external.
  4. In the Default field, for each reply template enter Internal or External.
  5. Switch to the User portal.
  6. In the User portal, from the Explorer panel, select Administration.
  7. Go to Microsoft Integration, and enter your internal domains into the Internal domains field.
  8. Click Save.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

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