Getting started with Spark

Nexthink Spark is an AI agent that interprets and resolves level-1 IT requests and questions across real-time communication channels. Nexthink Spark is currently only available for MS Teams.

By accelerating issue resolution, Spark reduces IT support workloads and enhances the employee experience.

Before you begin

Before deploying and using Nexthink Spark, ensure you have:

  • Configured Spark prerequisites which require administrator permissions. Refer to the Granting permissions for Spark section.

  • Configured Collector to gather the UPN for each user in clear text. Refer to the Configuring Collector level anonymization documentation.

  • Configured the Microsoft Entra ID inbound connector for your Microsoft tenant.

  • A Self-service portal URL.

  • The updated version 1.2.0 of the Nexthink Teams application package that was shared with you by email upon inclusion in the technical preview.

Nexthink recommends configuring ServiceNow connector credentials to enable incident creation directly from Spark. This integration enhances the ability of Spark to escalate unresolved issues with full context.

Setting up Nexthink Spark

1

Set up a communication channel for Spark-Teams interactions

Ensure that you meet the prerequisites to set up a Teams communication channel:

  • Use the Collector option to gather the UPN for each user in clear text. Refer to the Configuring Collector level anonymization documentation for more information.

  • Configure a Microsoft Entra ID inbound connector for your Microsoft tenant.

Set up a communication channel in Nexthink to enable Spark interaction with MS Teams.

  • After setting up the communication channel, install the version-specific application package (.zip) for Spark, which Nexthink has provided directly for this technical preview.

  • Use the welcome message to inform employees about the chatbot's scope and remind them to exercise judgment when reading AI-generated replies.

2

Grant permissions

Edit your roles to add permissions related to Spark functionalities for administrators:

  • Data model visibility:

    • Agent conversations enables users to view conversation information from Spark using Nexthink Query Language (NQL).

  • Spark:

    • View agent overview dashboards enables users to see overview dashboards to monitor the adoption and value of Spark.

    • Manage all agent actions enables users to manage the agent actions that are available to Spark.

    • View all agent conversations enables users to see a list of Spark conversations and their details including the conversation content.

    • Review agent conversations enables users to give feedback about Spark conversations that are used to improve Spark (not currently used).

    • Manage agent knowledge sources enables users to upload knowledge base articles that Spark can access (not currently used).

3

Configure connector credentials for ServiceNow integration

Set up connector credentials for ServiceNow in Nexthink to allow Spark to raise tickets when it cannot solve an incident. Nexthink is planning other ITSM tool integrations for future releases.

  • Ensure that the credential used has the required permission in ServiceNow to read and create incidents, e.g., has the itil role.

  • Provide Nexthink with the credential configuration URL, the list of required ticket fields and your self-service portal URL.

Nexthink completes the initial setup, enabling Spark for ticket/incident creation— there is a plan for customer-facing UI for future releases.

Refer to the Connector credentials documentation for more information.

4

Import knowledge base articles from ServiceNow

Manually upload knowledge base articles from the ITSM tool, ServiceNow, as CSV files into Nexthink to feed the Spark knowledge base.

Step 1 - Identify data to export within ServiceNow
  1. Open the list of knowledge base articles in ServiceNow.

  2. Select knowledge base articles by applying these filters:

    • Published articles only.

    • Articles available to your service-desk users. Spark indexes every uploaded article regardless of ITSM permissions.

    • Exclude translated versions of the same article.

    • Include every article you want to import—uploading a new file replaces the previous import.

Manual uploads are not incremental. Plan to export all the data required for the Spark knowledge base. When uploading a new file, the new content replaces the previous content.

Step 2 - Export data from ServiceNow

Export data from ServiceNow by performing a standard CSV export:

  1. Navigate to your knowledge base articles list in ServiceNow.

  2. Click Apply filter to configure the desired filters.

  3. Click the cogwheel icon > Personalize list.

  4. Add these required columns:

    • Number

    • Short description

    • Knowledge base

    • Category

    • Updated

    • Article body

  5. Click the action menu in any column header and select Export > CSV to download the file.

Ensure the file is UTF‑8 encoded. If your ServiceNow instance is not configured to perform UTF-8 exports by default, convert the file to UTF-8 afterward.

The table below lists the fields that you are expected to add when using a personalized list.

Column name
Description

number

Identifier of the knowledge base article (user readable)

short_description

Title of the knowledge base article

kb_knowledge_base

Name of the knowledge base the article belongs to

kb_category

Category of the knowledge base article

sys_updated_on

Last update date

text

Article content, in one of the supported formats: plain-text, markdown or HTML

Step 3 - Upload articles into Nexthink
  1. Go to Administration  > Autopilot connector  > Knowledge base.

  2. Click Upload CSV file.

  3. Choose the CSV file, up to 100 MB, from your hard drive to import it into the system.

  4. After you click Import, the system takes the following steps:

    • If you have already manually uploaded a file, the old content will be discarded and replaced by the new content.

    • File processing occurs asynchronously and may take up to 15 minutes for large knowledge bases.

5

Enable diagnosis and remediation actions for Spark

Validate and enable actions for Spark in Nexthink.

Enable built-in agent actions

From the main navigation menu:

  1. Go to Spark > Manage actions and review the Agent actions designed to work with Spark.

  2. Enable the desired Agent actions for Spark use.

Refer to the Managing Agents actions documentation for more information.

Activate custom remote actions

From the main navigation menu:

  1. Go to Remote Actions > Manage remote actions.

  2. Create or edit a remote action, ensure you enable the Spark trigger.

Refer to the Spark actions documentation for more information

6

Communicate Spark deployment

Select the employee group for Spark deployment and prepare communications.

  • Use the controls in the MS Teams admin console to select the employees with Spark access.

  • Inform employees about the scope of the Spark agent and remind them to exercise judgment when reading AI-generated replies.


How does Spark work?

Spark connects with employee requests across configured channels, runs a diagnosis and attempts issue resolution.

The diagram above visually maps the Spark workflow sequence:

  1. The employee reports, in real time, an issue via enterprise chats or other supported front-end channel integrations—currently only available for MS Teams.

  2. Spark interprets the employee request in natural language—using LLMs hosted in the AWS Bedrock service within the Infinity platform. Depending on the employee request, Spark gathers and evaluates:

  3. Spark responds to the employee by sharing answers to employee questions or potential solutions to resolve their issues. Spark can either:

    • Provide self-help guidance or detailed information, including links to related knowledge base articles.

    • Request employee authorization for automated resolutions of device issues.

  4. If unresolved, Spark escalates the support request to the service desk with full context. Spark only escalates requests in the following cases:

    • After exhausting relevant automatic actions and user troubleshooting

    • Receiving an explicit escalation request from the employee

    • Running into issues that require administrative access that the employee does not have

    • Encountering technical limitations that prevent Spark from providing an effective solution

Spark may suggest and initiate resolution measures, but all device remediation actions require user approval.

What data does Spark use?

Spark relies on a combination of static and dynamic data sources:

  • Knowledge base articles: Manually imported knowledge base articles.

  • Contextual Nexthink data: Device health, diagnostics, remediations and user metadata from Nexthink Infinity.

Planned data enhancements for future releases:

  • Conversation feedback: In the Spark Cockpit, supervisors provide conversation feedback to help improve response quality in similar, future interactions.

Consequently, Spark relies on specific NQL data model tables to query Spark-user interaction data.

Personal data handling is covered under the Nexthink Data Processing Agreement (DPA). Spark processing is user-specific and restricted to the customer region.

Spark never provides data from other organizations.

Granting permissions for Spark

Refer to the Roles documentation for a detailed description of Permissions, View domain options and Data privacy granularity settings.

To enable proper permissions for Spark as an administrator:

  1. Select Administration > Roles from the main navigation panel.

  2. Create a New Role or edit an existing role by hovering over it.

  3. In the Data model visibility section, set Agent conversations to visible.

  4. In the Permissions section, scroll down to the Spark section to enable appropriate permissions for the role.

View domain impact on Spark permissions

The table below shows what users with full and limited View domain access can do, assuming the necessary permissions are enabled.

Permission
Full access
Limited access

Manage all agent actions

Review agent conversations

View agent overview dashboards

View all agent conversations

Last updated

Was this helpful?