Platform Documentation

Ask AI

Ask AI lets you ask questions about device data and draft widgets, alerts, and tag changes in plain language. It uses your current account or application scope. On supported pages, it also receives a small summary of the page and selected items.

You approve changes. Ask AI can prepare a widget or alert, but you save it in the normal editor. Tag changes appear in a Confirm/Cancel card and take effect only after you select Confirm.
Ask AI answering a question or returning a draft widget, alert, or tag change
Ask AI answers in the chat or returns a draft action for you to review.

Quick Start

Open the chat and ask one clear question.

  • 1
    Select Ask AI in the lower-right corner. The main chat opens as a sidebar.
  • 2
    If the question concerns specific devices, select + below the welcome message and choose them. Device selection is optional.
  • 3
    Enter the question. Include the metric, device, and time period when they matter. For example, “What was the highest temperature this week, and when did it happen?”
  • 4
    Review the reply. For a widget or alert, select the action button, check the prefilled editor, and save.
Ask AI sidebar with settings, history, new chat, device selection, and message controls
The main Ask AI sidebar.


Ask AI button in the lower-right corner of an application page
Select Ask AI to open the chat.
Start from a dashboard widget. Point to a widget and select its sparkles Ask AI control. On a touch device, find it in the widget’s More menu. The chat opens with a question about that widget already entered. Edit the question or send it as written. This control appears only if you have Ask AI access.
Sparkles Ask AI control in a dashboard widget toolbar
The highlighted sparkles control opens Ask AI for that widget.


Ask AI composer prefilled with a question about a selected dashboard widget
The widget title and data are included in the prefilled question.

What the AI Can Actually Do

Ask AI can read permitted account data, analyze it, and prepare actions. A request may use more than one lookup before the reply appears.

Request What Ask AI returns Example
Look up readings Current or exact-time values, when a value or state occurred, or devices whose values match a condition. “Which devices have humidity above 70?”
Find a high or low The maximum or minimum value, with its time and device. “When was the lowest humidity yesterday?”
Analyze a period Trends, averages, totals, reading counts, and event or state-change counts. “Summarize the temperature trend for the last 7 days.”
Check devices Device counts and lists, connection state, available attributes, and device health based on alert events. “Which devices are offline or have active problems?”
Draft a widget An inline preview and an Add to Dashboard button. The main chat supports standard, calculated, and multi-series widgets. “Chart the difference between temperature and humidity this week.”
Draft an alert A prefilled alert with conditions, severity, recipients, and optional lock settings. “Email the on-call group when temperature exceeds 75.”
Manage tags A tag list or a proposal to create, edit, or delete tags. Changes require confirmation and are available in the main chat only. “Create tags for floors 1, 2, and 3.”
Find product help The page and action used to complete a task in NEQTO.ai. “Where do I add a device endpoint?”
The Smart Building Ask AI panel can answer data and device questions and prepare alerts. It does not create widgets or manage tags. Ask AI may ask a short follow-up when it cannot safely choose between devices, attributes, or time periods.

Answers from what is on your screen

On supported pages, Ask AI receives the page name and a limited summary of visible data. This lets it answer questions such as “What does this chart show?” without making you restate the chart. It does not inspect every field on every page. If the page summary is not enough, it can query data you have permission to view or ask for more detail.

Check important results. AI output can be incomplete or incorrect. Review values, time periods, alert conditions, recipients, and calculated formulas before relying on them.

How to Phrase a Good Request

Use the device and attribute names shown in NEQTO.ai. Add a time period and desired result when needed.

Include Example
Attribute temperature_celsius, humidity, connection state
Device or scope Boiler Room Sensor, selected devices, all devices in this application
Time period today, yesterday, last 3 hours, this week
Desired result current value, highest value and time, summary, chart, gauge, or alert

You can use common shorthand such as “temp,” but exact names help when the account has similar attributes or devices. If you omit a time period, Ask AI chooses one based on the request and the available data.

Suggested Ask AI prompts for the current page
Starter prompts provide examples suited to the current page. Select one to send or edit it.

Devices (Main Chatbot)

Device selection gives Ask AI a clear scope before you send the first question.

Device selector expanded below the first Ask AI message
Select devices, confirm the selection, or skip this step.
  • Select + below the first message to choose one or more devices. References such as “this device” then use that selection.
  • The selector lists devices from the current application when you are inside one. You can skip selection and name devices in the message instead.
  • There is no separate date picker in the current chat. State the period in the message when it matters.

Turning a Reply Into a Widget or Alert

Ask AI prepares the configuration. You review and save it in the standard editor.

Add to Dashboard (main chatbot)

Ask for a chart, gauge, label, table, or another supported widget. The reply includes a preview and an Add to Dashboard button when you have widget-create permission. Select the button, choose a dashboard in the Widget Editor, review the settings, and save. After a successful save, that message is marked as completed.

The main chat can also prepare calculated widgets, such as a difference, sum, or ratio, and charts with more than one series.

Calculated widget preview with the Add to Dashboard button highlighted
A calculated widget preview inside the chat reply.
Widget Editor prefilled with a calculated widget from Ask AI
Check the prefilled Widget Editor before saving.
You need at least one dashboard before you can save a widget. If none exists, the editor asks you to create one.

Add Alert (both chatbots)

Describe the condition and notification recipients. The reply includes an Add Alert button and a parsed configuration. Select it to open the Alert dialog, then review and save. The backend checks alert-create permission when you save.

Ask AI alert draft with the Add Alert button
An alert draft ready to open in the Alert dialog.
Check every condition, the AND or OR logic, severity, notification recipients, and lock behavior. The draft is a starting point, not a substitute for reviewing the alert.

Managing Tags

In the main chat, you can list, create, edit, and delete account or application tags.

It proposes, you confirm

Ask AI shows a Confirm/Cancel card for every tag change. The card lists the proposed values and types. Select Confirm to apply the change or Cancel to leave the tags unchanged.

Ask AI card proposing three tags with Confirm and Cancel controls
Review proposed tags before creating them.

Create several at once

Paste a list or enter comma-separated tags to propose up to 50 in one message. Ask AI assigns a name, value, and type to each row. Tag names can contain up to 25 characters. The confirmation card flags invalid rows and excludes them from creation. If the list reaches 50 rows, send any remaining rows in another message.

Tag creation card with one valid row and one invalid row marked as skipped
Invalid rows are marked before confirmation.

Rename, edit, or delete

An edit proposal shows the current tag and the proposed value. A delete proposal identifies the exact tag to remove. Both actions wait for confirmation.

Tag rename proposal showing the current and proposed tag
Check the before-and-after values before confirming an edit.


Tag deletion proposal with Confirm and Cancel controls
A delete proposal names the tag that will be removed.

Just looking

Asking Ask AI to list tags is read-only. The reply shows each tag’s name, value, and type without confirmation controls.

Read-only list of tags returned by Ask AI
Listing tags does not change them.
Tag actions use the permission for their scope. An account tag needs the matching account tag permission. An application tag needs the matching application tag permission. Without it, the card explains why confirmation is unavailable.

Settings, History, and Sessions

You set Temperature in AI Model Settings. Ask AI saves chat sessions for the account, so other account users see the same History.

Temperature (creativity)

Open AI Model Settings from the settings icon to change Temperature. The accepted range is 0.0 to 2.0, and the default is 0.1. Lower values produce more consistent wording. Higher values allow more variation. The browser stores this setting and shares it between the main and Smart Building chats.

AI Model Settings dialog with a Temperature field set to 0.1
Temperature accepts values from 0.0 to 2.0.
Ask AI limits the temperature used to choose an action, even if you select a higher value. Raising Temperature therefore affects the wording more than the data lookup or action it chooses.

Chat history

Ask AI creates a saved session when you send the first message. Open History to see sessions with the newest activity first. Select a session to restore its messages and continue the conversation. The main and Smart Building chats show separate history lists.

Ask AI history list with saved sessions and deletion controls
Open a saved session or delete sessions you no longer need.
  • New Chat starts a new conversation without deleting the previous one.
  • You can delete one session or select several and delete them together. Deletion requires confirmation and cannot be undone. Because History is shared across the account, deleting a session removes it for other account users too.
  • Sessions and messages are stored for the account, not only in the current browser. Other account users with Ask AI access can see the same history.
  • Sidebar open state, width, and Temperature are browser settings and do not follow you to another browser.

Connection

Ask AI needs a live connection while it processes a request.

  • A typing indicator or activity label appears while Ask AI works. Some replies appear a piece at a time, followed by the completed message.
  • If the connection fails, the chat reports the failure and attempts to reconnect. Send the message again if no reply arrives.
  • Reloading during a request can interrupt the reply. The session remains in History, but the unfinished answer may be missing.
  • Some page changes reset the messages currently shown in the panel. Reopen the saved session from History to continue.

Limits and Good to Know

Plan limits, permissions, and application scope still apply in chat.

Limit What it means
AI usage Ask AI consumes the token allowance included with the account’s plan. The allowance uses 30-day periods based on the plan start date. Requests stop when the allowance is exhausted and resume when the next period begins or the plan changes.
Demo limit The public demo may limit the number of questions in a session. The displayed error gives the applicable limit. This does not apply to a normal signed-in account.
Ask AI permission You need Ask AI access to see the chat or a widget’s Ask AI control.
Action permissions Widget creation requires widget-create permission. Alert permission is checked when you save the alert. Tag creation, editing, and deletion require the corresponding permission for the tag’s account or application scope.
Application scope Inside an application, Ask AI limits device and tag operations to that application’s scope.