Modifying the default Locations ServiceNow tool settings

As an administrator, configure the Locations ServiceNow tool to help agents retrieve location details from the ServiceNow environment and respond to location-related queries through the Employee Navigator interface. This setup improves accuracy and helps employees to find organizational location information directly in Microsoft Teams.

The Locations ServiceNow tool is available in HelixGPT Agent Studio, but you cannot modify it directly. However, you can add a new tool to customize the default tool configuration.

Before you begin

Make sure you have cloned a prebuilt agent, because you can only add a custom tool to a cloned prebuilt agent.

For more information, see Cloning an agent.

To modify the default Locations ServiceNow tool settings

1. Add a new tool in your environment. For more information, see Creating and editing tools and toolkits.
   The new tool must replicate the field value configuration of the existing out-of-the-box Locations ServiceNow tool.
2. In the Configuration field, modify the following settings:

   Setting	Description
   sys_params	A comma-separated list of fields that define the location item attributes returned in the response. The sys_id, and name are always included in the response, even if they are not added.
   sys_query	A comma-separated list of fields to search. Falls back to default if empty, invalid, or non-string type.
   limit	The number of location records returned per query.
   addressable_locations_only	A boolean value that indicates whether to return only locations that have actual addresses.

   Default configuration:

   {
     "sys_params": "full_name,city,street,country,zip,phone,latitude,longitude",
     "sys_query": "name,full_name,street,city,phone",
     "limit": 10,
     "addressable_locations_only": "true"
   }
3. Click Save.

Where to go from here

Creating and editing tools and toolkits