> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/user-guide/spark/setting-up-and-managing-spark/managing-spark-settings.md). # Managing Spark settings and data inputs Use the **Settings** tab on the **Manage Spark** page to configure data inputs, along with general settings such as the assistant name and whether Spark can search the web. Keeping these sources connected and up to date improves answer quality and helps reduce unnecessary escalations. ### Accessing Spark Settings To access the Spark Settings page, navigate to **Spark > Manage Spark** and select the **Settings** tab.
Some settings, such as the assistant name and web search, you configure directly on this page. Others link out to where you configure them. Each setting shows its configuration status. Click on the blue configuration item label to open details in the right-side panel.
### Customizing the assistant name Customize the name Spark uses to identify itself during conversations. When employees interact with Spark, it introduces itself using the name you provide here. To customize the assistant name: 1. Open the **Spark** module from the main menu and select **Manage Spark** from the navigation panel. 2. Enter a name in the **Assistant name** field. 3. Click **Save configuration**. For a consistent employee experience across channels, also customize the display name and logo Spark uses in Microsoft Teams. For more information, refer to [Spark Microsoft 365 app security](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/platform-security/spark-microsoft-365-app-security). ### Enabling web search in Spark If Spark cannot find sufficient information in customer-specific sources, such as knowledge base articles or past ticket resolution data, it can search external web sources for additional guidance. These include documentation sites of relevant device manufacturers, application providers, and related parties. Spark always prioritizes customer-provided content and does not override high-confidence internal guidance with external information. It also records the accessed URLs in its reasoning logs to support monitoring and troubleshooting. Spark web search is enabled by default. To turn it off or back on: 1. Open the **Spark** module from the main menu and select **Manage Spark** from the navigation panel. 2. Navigate to the **Settings** tab. 3. Select or deselect **Web search**. 4. Click **Save configuration**. #### Spark default domains Nexthink provides a baseline of 145 default trusted domains for Spark. These default websites meet the following allowlist criteria, designed to ensure that approved domains provide trustworthy, relevant, and actionable information that supports Spark's troubleshooting and support capabilities.
Security * Domain reputation is verified and not associated with malware, phishing, or known CVEs. * HTTPS is enforced with a valid, non-expired certificate. * No known history of domain hijacking or typosquatting activity.
Legitimacy & Ownership * The domain is owned by a known and trusted vendor or official organization, such as Microsoft, Cisco, or NIST. * Domain ownership can be verified through WHOIS records. * The domain is not recently registered or anonymized.
Necessity * The domain serves a clear and documented purpose tied to a specific troubleshooting use case. * The domain is included according to the principle of least privilege and only when required for Spark to perform a specific task.
Data Exposure Risk * The domain does not unintentionally receive sensitive telemetry or credentials. * The domain does not aggregate or resell access logs.
Stability * The domain is stable, long-lived, and maintained by an established provider. * The domain is not ephemeral or anonymously proxied through unmanaged infrastructure. * The domain hosts official documentation or API references rather than unofficial mirrors or reposted content.
Auditability * Each allowed domain has a documented justification and assigned owner. * Allowed domains are reviewed on a defined schedule, such as quarterly
Usefulness * The domain is relevant to technologies and services used by the company. * The domain contains actionable troubleshooting content, such as how-to guides, knowledge base articles, error code references, CLI references, configuration steps, or API documentation. * The domain provides information relevant to the IT support scope, such as endpoints, SaaS applications, identity providers, networking, security tools, or hardware. * The domain includes operational or incident-related information, such as status pages, incident reports, known issues, or Common Vulnerabilities and Exposures (CVE) advisories. * The content is well-structured, versioned, stable, and suitable for automated processing. * Access to the domain helps reduce manual escalations and improve autonomous issue resolution.
{% hint style="info" %} For the complete and up-to-date list of Spark default domains, log in to Nexthink Community and open [Trusted web domains for Spark web search](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/trusted-web-domains-for-spark-web-search). {% endhint %} #### Managing Spark trusted websites Control which websites Spark can search by enabling or disabling Spark default domains. Add or remove your own domains to extend the domains Spark searches beyond its default list. To manage Spark trusted websites, click on the three dots icon next to the Web search box on the **Manage Spark > Settings** page and select **Edit**. This opens a dialog box with the following configuration options:
* Use the **Filter domains** search bar to find an existing domain. * Enable or disable default or custom domains using the toggle. * Add a custom domain: * Click **Add domains**. * Paste a domain, a full URL, or a list of domains — one per line or comma-separated — into the box. * Click **Add domains** to confirm. * Select or deselect the toggle next to a domain to enable or disable it for Spark. * Remove a custom domain by clicking the trash icon. * Click **Save domains** to apply the configuration. {% hint style="info" %} Spark does not validate custom domains for the allowlist criteria applied to the default list. {% endhint %} {% hint style="warning" %} Spark supports up to 300 domains total, combining Spark default and custom domains. Disabled domains still count toward this limit. Delete a custom domain to free up capacity. {% endhint %} ### Enabling storage troubleshooting for Spark Give Spark access to the names, sizes, locations, and dates of files and folders on an employee device. This helps Spark identify storage issues and propose remediation actions. Example use cases include identifying large files, clearing unnecessary or oversized content, and suggesting alternative storage options. File and folder names are visible only in user chat sessions, but are hidden in the conversation details dashboard. Storage troubleshooting is enabled by default. To turn it off or back on: 1. Open the **Spark** module from the main menu and select **Manage Spark** from the navigation panel. 2. Navigate to the **Settings** tab. 3. Select or deselect **File and folder names**. 4. Click **Save configuration**. ### Managing knowledge sources Knowledge base articles help Spark provide guidance aligned with company policies and recommended practices, whether uploaded manually or synced from ServiceNow. They cover both employee-facing and IT support content, and Spark classifies them by intended audience to determine how to use them during search and resolution. The **Knowledge sources** section shows how many articles and records each source contributes to Spark's answers. Its status label reflects the configuration progress of these sources. A single knowledge source, manual or connector, is enough for Spark to use it. #### Manual articles Manual articles are knowledge base articles you upload directly as CSV files. Click **Manage knowledge sources** to open the **Knowledge management** page in the **Administration** module, where you upload and manage these articles. #### Knowledge base connector The knowledge base connector syncs knowledge articles automatically from ServiceNow every day, keeping Spark's answers current without manual uploads. Refer to [ServiceNow Knowledge Base connector](/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-servicenow-knowledge-base.md) for configuration instructions. ### Enabling Tickets connector for Spark The tickets connector uses resolution notes from past ServiceNow incidents and requests to suggest fixes for similar issues. This helps Spark assist employees in complex scenarios by leveraging previously applied solutions and expert knowledge, reducing manual intervention and escalations over time. The page displays the **Tickets connector** status, based on whether a connector instance exists in the Nexthink web interface. If complete, enable it for Spark using the toggle. Refer to [ServiceNow Tickets connector](/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/servicenow-tickets-connector.md) for configuration instructions. ### Enabling Request Catalog connector for Spark The request catalog connector ingests the ServiceNow catalog structure, forms, and request metadata. Spark uses this to guide employees to the right service request and submission process. The page displays the **Request Catalog connector** status, based on whether a connector instance exists in the Nexthink web interface. If complete, enable it for Spark using the toggle. Refer to [ServiceNow Request Catalog connector](/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-servicenow-request-catalog.md) for configuration instructions. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.nexthink.com/platform/user-guide/spark/setting-up-and-managing-spark/managing-spark-settings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.