Luzmo IQ is designed to work with any data source, data structure, and within any industry or context. While this is a great starting point, there are several options to influence how Luzmo IQ answers questions. Tweaking your Luzmo IQ setup to match the expectations of your customers will greatly improve its effectiveness.

Before tuning IQ specifically, make sure your data is set up well for AI in general — unambiguous names, correct column types, prepared formulas, descriptions, and AI Context. That foundation benefits every AI feature, not just IQ. See Preparing your data for AI and Improve Luzmo IQ answers with AI Context before continuing here.

Where to add context

With descriptions, AI Context, and the custom prompt all available, it can be unclear where a given piece of context should go. There is no strict priority order between layers — a dataset-level rule does not override a column-level one, both are simply included. Instead, think of it as choosing the right scope for each piece of context:

  1. Context on the resource itself
    • Dataset context: what the dataset contains, when and how to use it, and what to avoid.
    • Column/formula context: the same, but specific to that column or formula.
    • Dashboard context: helps the dashboard agent (and IQ, when scoped to that dashboard) understand the dashboard's purpose and audience.
  2. Context on the embed token (iq.context): general IQ behavior (response style, business background), or end-user-specific detail (sub-org, job role, preferred filters).
  3. Context on the AIPrompt API request itself: page-specific or request-specific context, for example results from a knowledge-base lookup performed before sending the request. This is only available if you're building your own chat or agentic workflow — not with the in-dashboard/embedded IQ chat component.

As a rule of thumb: put broad rules at the dataset level, and specific rules at the column or formula level. If a rule spans two related columns, either place it at the dataset level or duplicate it on both columns — there's no dependency mechanism between columns today.

Add a custom prompt

Luzmo IQ allows you to programmatically add context to the LLM prompt through the embed token. This gives you tremendous control in steering Luzmo IQ towards specific outcomes, without exposing these instructions to your users. The following tips will help to write an effective prompt:

  1. Write the prompt as if you're writing an instruction for a human data analyst that's new to your business.
  2. Keep the prompt as short as possible. Any instruction you add will decrease the attention for other individual instructions. Prompt size also has an effect on speed.
  3. Be specific. Explain what you expect and what you don't expect. Give examples.
  4. Adding a custom prompt to Luzmo IQ is not required. It's best practice to only add custom prompting for things you want to change or improve.

Example 1: Adding business context


Example 2: Add context to help to select columns for common questions. Assume a "Projects" dataset with has several columns with cost information, like actualCost, budgetedCost, or billedCost, you can prevent Luzmo IQ to make unexpected selections.

Option 1: Prescribe a default


Option 2: Force follow-up questions


Example 3: Add instructions on how to create text and chart answers

Set default periods for displaying time-based data


Provide instructions for writing large numbers


You can personalize the custom prompt for individual users through the embed token. In the above example, this allows you to instruct the use of long-scale or short-scale number notation depending on localization settings.

Increasing speed

Luzmo IQ is set up to generate answers as fast as possible without sacrificing accuracy and consistency. The speed with which answer are generated depends a great deal on the size of the datasets connected. There are a few options to positively influence answer speed:

Limit historic data

In most cases, Luzmo IQ serves a different purpose than dashboards. Often, users want to understand events that are happening now. With that in mind, it might not be necessary to feed the full data history of your datasets to Luzmo IQ. Consider setting an embed filter on the embed token to limit your data to, for example, the past year.

Alternatively, consider adding a custom prompt that instructs Luzmo IQ to only consider a recent period by default. This will still allow users to ask questions outside that default period.

Warp

A data source that's not optimized for analytical queries will have a bigger negative impact on Luzmo IQ than other Luzmo charts. To formulate a single answer, Luzmo IQ might do multiple queries.

Consider using Warp to speed up queries made by Luzmo IQ.

Other setup details that affect answer quality

Embed token access

Luzmo IQ requires at least "use" access to a dataset. Datasets where the embed token only has "read" access are silently excluded from IQ, even if the end user can see them elsewhere in your product.

Link related datasets

Luzmo IQ cannot correlate or combine data across datasets that aren't linked. If you expect cross-dataset questions (for example, "which reps with the highest win rate completed the most training"), link those datasets wherever the relationship allows it.

Quick setup checklist

  • Descriptive, unambiguous dataset and column names — see Preparing your data for AI
  • A description on every dataset and key columns — see Improve Metadata
  • AI Context added to datasets, columns, and dashboards where business rules or caveats aren't obvious from the schema — see Improve Luzmo IQ answers with AI Context
  • The right context placed at the right scope (dataset vs. column/formula vs. embed token vs. API request)
  • Correct column types and subtypes (currency, duration, date, etc.) — see Preparing your data for AI
  • Custom formulas for commonly used metrics — see Preparing your data for AI
  • Embed tokens grant at least "use" access to datasets IQ should consider
  • Related datasets linked where cross-dataset questions are expected
  • Disambiguation rules and other steering instructions added to the custom prompt
Previous
Next

Need more information?

Do you still have questions? Let us know how we can help.
Send us feedback!