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 out-of-the-box, 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 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 Locations ServiceNow tool settings

1. Add a new tool in your environment. For more information, see Adding tool and toolkit for an AI Agent.
   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

Adding tool and toolkit for an AI Agent