NetLock RMMNetLock RMM Docs
II — Console Reference

AI Chat

The console's general-purpose AI assistant page: conversations, attachments, and how it differs from the Scripts editor's AI Assistant.

AI Chat

The AI Chat page at /ai-chat is a general-purpose AI assistant embedded in the console. You type a question and get an answer, as in any chat assistant. Typical uses are quick lookups, explaining log output, drafting a customer email, or checking a configuration choice before you make it.

The feature depends on three switches. Two are deployment-wide and live under Settings → AI/LLM, which also holds the model source and provider configuration: the Enable AI Features master toggle, and the AI Chat feature toggle that covers this page, the slide-in chat panel, and the chat button in the top bar. The third is ai_chat_page_enabled, a per-user permission for this page.

With AI switched off deployment-wide, the page shows the message "The AI provider has not been enabled. Ask your administrator to configure it under Settings → AI / LLM." and no conversation can be started. With ai_chat_page_enabled off, the page is not in the user's navigation menu.

AI Chat page with sidebar of grouped conversations and the chat pane active

13.1 The chat UI

The page is a two-column layout: the conversation sidebar on the left, and the active chat on the right.

The sidebar lists your past conversations. At the top:

  • New chat: starts a new conversation.
  • A search field with placeholder text Search conversations... that filters the list by title.

Below, conversations are grouped by recency:

  • Today
  • Yesterday
  • Last 7 days
  • Last 30 days
  • Older

Each conversation shows its title, the time of its last update, and an optional context badge when the conversation was started from another part of the console (for example, when you launched the chat from the Analyze with AI button on an event).

Chat pane

The chat pane is the right column. It shows:

  • A header strip with the AI avatar, the conversation title, the optional context badge, and Rename and Delete controls.
  • The message area, with date dividers between different days.
  • Chat bubbles: your messages right-aligned, the AI's responses left-aligned with the AI avatar.
  • Markdown rendering for AI responses: code blocks, numbered and bulleted lists, tables, links and blockquotes.
  • A typing indicator while a response is being generated.
  • Streaming updates as each chunk of the response arrives, so the answer appears incrementally rather than all at once.

For questions about NetLock RMM itself, the answer is based on the product documentation that ships with the console. The model receives the documentation sections that match the question and cites them as [1], [2] and so on. The console turns those citations into a Sources line at the end of the answer, with links to the documentation pages used; the links open in a new tab.

Where a documentation section has a screenshot of the page in question, the answer shows it below the step it illustrates. The screenshot comes from the copy bundled with the console, and a click opens it in full size in a new tab.

If the documentation does not cover a question, the answer says so briefly and points to the online manual. General questions (scripting, operating systems, networking) are answered from the model's own knowledge without citations. The switch and the amount of documentation sent per request are set under Settings → AI/LLM; see A.11.5.

Composer

At the bottom of the chat pane:

  • A file attachment control, labelled Attach text-based files (max 10 MB each).
  • The message textfield, with placeholder Type your message... normally and AI is responding... while a response is streaming.
  • A send button that swaps into a stop button while streaming. Pressing stop cancels the current response.

13.2 Conversations

Creating a conversation

Clicking New chat creates an empty conversation with an auto-generated title. The title is derived in this order:

  1. From the first message text, trimmed to a short string.
  2. From the first attachment name, if the first action is attaching a file.
  3. From the literal New Conversation, if neither of the above applies.

You can rename a conversation at any time from the Rename button in the chat pane header.

Renaming a conversation

The Rename Conversation dialog accepts a new title in a single text field. Submit to save; the new title appears immediately in the sidebar list.

Deleting a conversation

The Delete Conversation dialog asks for confirmation. Deletion is permanent: the conversation and all its messages are removed. The dialog is titled Delete conversation and needs one click to confirm.

Exporting a conversation

The AI Chat page has no export, download or shareable link. To keep a record of a conversation, copy its content from the browser.

13.3 Attachments

The composer accepts text-based files, prepended to the outgoing message so the AI receives your prompt and the file contents together.

Composer with two text files attached and a prompt typed in

Allowed types and limits

  • File types: text-based only. More than 40 extensions are allowed: plain text, Markdown, source files across the major languages, YAML, JSON, XML, INI, CSV, logs, and configuration formats. Binary formats are not accepted.
  • File size: 10 MB maximum per file.
  • Files per message: up to 10 files can be attached to a single message.

How content is included

When you send, the content of each attached file is prepended to your message with markers so the AI can tell where each file starts and ends:

--- Attached file: {name} ({size}) ---
{file contents here}
--- End of {name} ---

The full content is sent without truncation, up to the 10 MB per-file limit. Very large prompts can exceed the provider's token limit; the response then shows an error.

Attachment View dialog

Click an attachment chip in an existing message to open the Attachment View dialog, which shows the file name, a size label, and the full content as it was sent. Use it to check what was sent to the AI.

AI Chat is a general-purpose assistant. It has no access to the console's data and cannot change anything in it.

Other AI features in the console

The AI Assistant button in the Scripts editor (see Chapter 8.1 — Scripts) is a separate integration. It sits in the Add Script and Edit Script dialogs, has its own inline panel, and writes directly into the script editor.

AI Chat cannot save its output to the Collections library. To keep a script the AI drafted, copy its code from the conversation, open the Scripts library, and paste it into a new script.

The AI Assistant buttons on the Automations dialogs, and the Widget Editor's AI SQL Assistant are integrations of their own, each tied to its page. The Analyze with AI button on Event Details opens the AI chat with the event as context.

Provider and model

The chat does not show the configured provider, model name or parameters. They are set under Settings → AI/LLM (see Appendix A.11) and are visible only to users with access to that Settings page. Ask your administrator which model answers.

Console data

AI Chat does not know your Scripts, Jobs, Sensors, Custom Fields, App Hub entries, Application Control rulesets or Device Control entries. It cannot look up a device, assign a policy or trigger a deployment. Use the relevant console page for these tasks.

13.5 Dialogs

DialogPurpose
Rename ConversationChange the title of the active conversation.
Delete ConversationConfirm permanent deletion of the active conversation.
Attachment ViewInspect the full content of an attachment in an existing message.

13.6 End-user AI Chat (tray)

Separate from the operator AI Chat page, NetLock RMM can give end users their own AI assistant in the agent's tray icon. It is enabled per policy and lets staff use AI under your control instead of pasting company data into an external chatbot.

How it works:

  • Opened from the tray. When enabled in the tray-icon policy, users open the chat from the agent's system-tray icon, without a separate app, browser or portal.
  • Encrypted history. Each user registers with a username (an email address by default) and a password. The conversation history is encrypted on the device with the user's password and stored encrypted; operators cannot read it. To answer, each message is passed through the NetLock server to the configured model. If the user forgets the password, the history cannot be recovered.
  • Relayed through the deployment's model source. Requests travel tray → agent → server → either the managed NetLock AI (hosted on IONOS AI Hub) or the provider configured for your own model, and are streamed back the same path. Which of the two applies is the deployment-wide Settings → AI/LLM model selection; see A.11.2.
  • Account control. New accounts are created inactive and must be activated by an operator, unless their tenant is set to auto-activate new accounts. Password rules and a required terms/privacy-acceptance step are configured per policy.
  • Token limits. Each account has an optional monthly token limit, and each tenant has an optional monthly cap that applies on top: when the tenant cap is reached, all of that tenant's users are blocked until the monthly reset, even if an individual user still has budget. Usage is shown as a percentage and can be reset per account.

Operators manage these accounts from the Customer AI dialog, reached from the Tenants list (all accounts the operator may see) and from a tenant's detail page (that tenant only, where the per-tenant cap and auto-activation are set). The dialog shows email, tenant, active state, token usage/limit, reset date, and per-period statistics. Conversation content is not shown. Access is gated by the enduser_ai_accounts permission and scoped to the operator's tenants.

The tray chat's title, labels, buttons and messages, and the username/email requirement, are configurable per policy. See Chapter 6 — Policies for the tray-icon AI Chat settings.

Permissions

FlagGates
ai_chat_page_enabledPer-user access to the AI Chat page. Users without this flag do not see the page in their navigation. The deployment-wide Enable AI Features and AI Chat switches under Settings → AI/LLM apply on top of it; when either is off, the chat page shows the disabled message regardless of per-user flags.
enduser_ai_accountsThe Customer AI dialog for managing end-user AI chat accounts: activation, per-user and per-tenant token limits, auto-activation, and statistics. Tenant-scoped.

See Appendix X.2 for the full permission catalogue.