Modifying the default DWP Event tool settings


As an administrator, configure the Digital Workplace (DWP) Event tool to capture and process events in BMC Helix Digital Workplace, triggering appropriate actions based on user activity or system events. 

The DWP Event tool is a toolkit comprising various tools for DWP events. Events include requests, approvals, appointments, and to-dos. By using this tool, users can search for events and view their requests, approvals, to-dos, and appointments. 

It helps the following AI agents to provide a list of events to the user or perform actions such as commenting or approving:

  • Employee Navigator
  • Employee Navigator - Cards
  • Employee Navigator - MS Teams
  • Employee Navigator Supervisor
  • Employee Navigator Supervisor - MS Teams

The DWP Event tool is available out-of-the-box, but you cannot modify it directly. However, you can add a new tool to modify the default tool configuration.

Before you begin

Make sure you have cloned an out-of-the-box agent, because you can only add a custom tool to a cloned out-of-the-box agent.

For more information, see Cloning an agent.

To modify the default DWP Event tool settings

  1. Add a new tool to your environment. For more information, see Adding tool and toolkit for an AI Agent.
    The new tool must replicate the same field values configuration as the existing out-of-the-box DWP Event tool.
  2. In the Configuration field, modify the following settings:
    SettingDescription
    truncateEachCommentToLengthMaximum length of the comment. Any comment that exceeds the length is truncated.
    maxCommentsToSummarizeMaximum number of comments to summarize.
    handlesCitationsTools

    Indicates if citations should be handled for the tools.

    A citation helps agents to include source or reference links directly within their response.

    The sources or references are displayed when citation is set to False.

    Default configuration:
    {
      "truncateEachCommentToLength": 1024,
      "maxCommentsToSummarize": 10,
      "handlesCitationsTools": [
        "GetRequests",
        "GetApprovals",
        "GetTodos",
        "GetAppointments",
        "GetPastEvents",
        "GetRequestDetails",
        "EventCommentClientAction",
        "EventCommentSummarization"
      ]
    }

  3. Click Save.

Where to go from here

Adding tool and toolkit for an AI Agent

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC HelixGPT 25.4