Skip to content
Stand with Ukraine flag

Prompts

Prompts are reusable templates that combine your expert instructions with live telemetry pulled from ThingsBoard. When triggered, Trendz automatically injects the relevant device or asset metrics into the template, submits it to the configured LLM, and displays the response alongside your data — no manual data gathering or prompt rewriting required.

Once saved, a prompt can be applied in two places:

WhereHow
Trendz widgetSelect a prompt per view in View Settings → AI Assistant. See AI Widget Summary — Set the Prompt.
ThingsBoard widget actionPass the prompt ID to trendz.getAnalytics() in a custom widget action. See AI Widget Summary — Customize with getAnalytics().

Click the Assistant icon in the left sidebar, then open the Prompts tab in the upper-left area of the workspace.

The Prompts table shows all available prompts with columns: Name, Updated, Created, Type, and Actions.

The Type column has two values:

TypeDescription
SystemBuilt-in prompts provided by Trendz. Cannot be renamed, edited, or deleted.
CustomPrompts you create. Can be renamed, edited, and deleted.
  1. Click New Prompt. The prompt editor opens.

  2. Write the prompt content in the editor.

  3. Enter a name for the prompt.

  4. Click Save.

Click any prompt row to open it in the editor and read its content. To copy the prompt ID — used when referencing a prompt from a widget custom action — click Copy prompt ID in the upper-right corner.

  1. Click the prompt row to open it.

  2. Click Edit.

  3. Update the content.

  4. Click Save.

Two ways to rename a prompt:

From the Prompts table: Click the three-dot menu in the Actions column, select Rename, type the new name, and press Enter.

From the editor: Click the pencil icon next to the prompt name, type the new name, click any free space to confirm, then click Save to persist the change.

Click the three-dot menu in the Actions column, select Delete, and confirm by clicking Yes.

The Run test feature lets you preview how a prompt will analyze real data before applying it to production dashboards.

  1. Open the prompt in the editor.

  2. Click Run test in the upper-right corner.

  3. In the test panel that opens on the right, choose one of your saved views from the Select View dropdown.

  4. Click Test prompt to generate the summary.

  5. Review the result.

The editor uses Markdown — a format that LLMs understand well and that keeps prompts readable for humans too.

Click Show Preview to split the screen: the left side shows the Markdown source and the right side shows the rendered output. Click Hide Preview to return to the single-pane view.

The toolbar in the upper-left of the editor provides one-click shortcuts for common Markdown blocks:

ShortcutBlock
BBold text
IItalic text
H1Heading
"Blockquote
🔗Link
🖼Image
Unordered list
1.Ordered list
<>Code block

Click the pencil icon next to the prompt name, type the new name, then click any free space to confirm. The name is not saved until you click Save.

After editing, click Save to apply all changes or Cancel to discard them. Both buttons are enabled only after a change is made.

Trendz includes six built-in system prompts available on every installation:

PromptPurpose
Trendz System Default Summary PromptConcise 2–3 sentence executive summary covering performance, sentiment, and emerging trends
Trendz System Operational Efficiency Optimization PromptDetects throughput or resource-use improvement opportunities; focuses on utilization gaps and bottlenecks
Trendz System Data Quality Review PromptHighlights data inconsistencies, outliers, and anomalies; evaluates impact on analysis
Trendz System Positive Performance PromptIdentifies areas of strong performance and growth potential; summarizes key positive trends
Trendz System Incident Identification And Prioritization PromptDetects anomalies, spikes, or rare behaviors in time-based or event-based datasets
Trendz System Root Cause Analysis PromptExplains the likely root cause of a performance issue with a confidence rating
PracticeGuidance
Be specificDescribe the exact question or analysis you want. Vague prompts produce vague responses.
Use Markdown structureUse headers, bold, and lists to organize the prompt. LLMs interpret structured prompts more accurately.
Keep it conciseLong prompts can dilute focus. State the task clearly and avoid padding.
Test before deployingUse the Run test feature with a real saved view to verify the output before attaching the prompt to a dashboard.
Use saved prompt IDsWhen referencing prompts from widget actions, use the prompt ID instead of inline text so you can update the prompt without touching widget code. See AI Widget Summary.
Name prompts clearlyUse names that describe the analysis goal, e.g. Boiler Root Cause Analysis instead of Prompt 3.