All Products
Search
Document Center

Quick BI:Conversing with Q Chat

Last Updated:May 26, 2026

Quick BI provides the Q Chat feature, an intelligent data assistant powered by ChatBI's interactive capabilities. Q Chat lets you get instant answers from your data by using natural language. This makes data analysis accessible to everyone and introduces a new way to consume data. You can use the Q Chat interface on your PC or mobile client to preview and select datasets, enter questions directly or use quick queries, engage in multi-round Q&A, and review past conversations in the conversation list.

This topic describes how to use Q Chat.

Important
  • Q Chat is a value-added feature that requires a separate purchase.

  • This feature is currently available only in the China (Hong Kong) , Malaysia (Kuala Lumpur) and Singapore regions. It will be rolled out to other regions soon.

Prerequisites

  1. Create a dataset and complete the Q Chat configuration.

  2. Obtain the required Q Chat resource permissions. For more information, see permission management.

Access on PC

On the Quick BI homepage, click Smart Q to open the Q Chat conversation page.

image

Data sources

Available data sources include all datasets that you can access with Q Chat. These datasets are located under the All tab and within each analysis subject.

image

Preview and select datasets

Select a single dataset

  • On the Q Chat conversation page, you can find datasets under the All tab and within each analysis subject. Hover over a dataset to Preview it or click Ask Question to query it directly.

    image

    • Click Preview (①) to view the dataset's Field Details and a Data Preview. From here, you can use a quick query or click Ask Question in the upper-right corner to open the Q Chat dialog box.

      • Field Details

        image

      • Data Preview

        image

        Hover over a dimension field to view its details.

        image

      • Quick query

        image

      • Ask Question

        Ask questions about the current dataset.

        image

    • Click Ask Question (②) to open the data Q&A interface and start querying the current dataset.

  • After you select a dataset, you can click the image icon next to the dataset name to preview its fields, including key metrics and analysis dimensions.

    image

    You can expand or collapse the data fields.

    image

  • During a Q&A session, you can preview data and switch datasets.

    • Preview data

      Click the image icon next to the selected dataset to open a Data Preview.

      image

    • Dataset switching

      1. Click the name of the selected dataset to view available datasets.

        image

      2. Hover over a target dataset and click Ask Question to switch to it.

        image

        You can also Preview the target dataset before clicking Ask Question.

        image

Select multiple datasets

If your question matches multiple datasets, you can select all relevant datasets for your query.

Note

This section describes only how to select multiple datasets. For other operations, see Select a single dataset.

  1. Enter your question.

    The system displays datasets that may be relevant to your question. You can select the datasets you need.

    image

  2. Select the checkboxes for multiple datasets and click Ask question based on selected data.

    image

  3. View the analysis results.

    image

Ask questions and get answers

Note

Q Chat supports multiple inference and data interpretation methods. This topic uses the default official methods as an example. For details on the results from other methods, see Inference and interpretation methods.

You can enter a question in the dialog box and send it. Q Chat supports direct question input, quick query, and voice input.

Enter a question directly

  • For example, type "What is the proportion of orders for each order level?" and send the question. The system returns the data analysis results and displays the analysis process on the right.image

    If you do not need to view the analysis process, click Analysis process expanded to hide it.

    image

    When the analysis process is hidden, only the chart is displayed.

    image

    To show the analysis process again, click Analysis complete.

    image

  • As you type, the system may provide recommended fields and recommended questions. For example, if you type "2024", the following recommendations appear. You can select the ones you need.

    image

Question clarification

When this feature is enabled, Q Chat asks clarifying questions to provide more precise answers. This occurs if your question is missing key elements, such as a time frame or a metric, or if it contains ambiguities between multiple metrics. For more information, see Enable Question Clarification.

image

In the question clarification dialog box, you can adjust the time period and analysis metric, then click Start Analysis.

image

You can also modify the question based on the proposed plan.

image

Alternatively, select Skip and answer directly to get an answer to your original question.

Favorite a question

Note

You can favorite a maximum of 30 questions.

  • Click the image icon to the left of a question to add it to your favorites.

    image

    You can access favorited questions from the quick query menu.

    image

    If no dataset is selected, you can click a favorited question to ask it directly.

    image

  • Click the image icon again to remove the question from your favorites.

    image

Copy a question

Click the image icon to the left of a question to copy the question text.

image

Quick query

  • Click the image icon in the lower-left corner of the input box to open the quick query menu. You can then select a question from the Favorites, Recommended, or Recently Used tabs.

    image

    On the Favorites tab, you can select the Automatically switch dataset checkbox. This option is selected by default. When selected, clicking a favorited question switches to its associated dataset before asking the question. If you clear this checkbox, Q Chat uses the current dataset for the question.

    image

  • You can also click one of the recommended questions above the input box.

    image

    Click the image icon to see a different set of recommended questions.

    image

  • After each round of conversation, you can also select one of the three recommended questions below the chart to continue your analysis.

    image

Voice input

Note

After you enable voice Q&A, you can ask questions using voice input.

image

  • Click the Voice input icon to open the voice conversation interface.

    image

  • In the voice conversation interface, ask your question.

    image

  • The system recognizes your speech and converts it to text.

    You can click the image icon on the left to cancel, or click the image icon on the right to switch to text input.

  • Click Send or press Enter. The system returns the data analysis results.

    image

View results

While viewing the data, you can use the following features.

image

  • Data filtering (①): The query conditions for the current data retrieval appear in the chart. You can change these filters.

    25

  • Chart switching (②): Change the visualization type to better suit your preferences. The available chart types vary based on the data.

    26

  • View AI data retrieval process (③): Verify that the retrieval results meet your requirements. You can view the business logic SQL and the executed SQL.

    image

  • Fluctuation attribution and trend forecast (④)

    image

    • Fluctuation attribution

      image

      Note

      Fluctuation attribution is available for KPI cards and line charts if the following conditions are met:

      • Supported chart types: KPI card and standard line chart (not a forecast line chart).

      • The chart contains exactly one dimension.

      • The dimension is a date type, and the chart has no legend.

      • The chart must be error-free.

      • Line chart requirements: 1 date dimension and 1 to 3 measures.

      • KPI card requirements: 1 date dimension and 1 measure.

      • Click the image icon in the upper-right corner to open the Attribution Report Settings.

        image

        You can modify the attribution metric, data interpretation approach, and model selection. After you click OK, the system automatically updates the attribution report. For more information, see Q Chat Insight.

    • Trend forecast

      image

      Note

      Trend forecast is available for line and bar charts if the following conditions are met:

      1. Supported chart types: Line chart or bar chart that contains a date dimension and has no legend.

      2. The chart is not a forecast result itself.

      3. The chart must be error-free.

      4. The chart must have 12 or more dimension values.

      5. Line chart requirements: 1 date dimension and 1 to 3 measures.

      You can click the image icon in the upper-right corner to share the trend forecast.

  • View in full screen (⑤).image

  • Rename (⑥)

    You can rename the result. You can also click the title area (highlighted in the red box) to rename it.

    image

  • Share data (⑦)

    You can copy the link to share.

    image

  • Export data (⑧)

    You can export the data as an Excel file. You can also specify a custom export name.

    Note

    The export function is available only on PC and is not supported on the mobile client.

    image

  • Data interpretation (⑨)

    Note

    This feature lets you initiate a custom data interpretation. You can specify the interpretation approach and model for the query result.

    image

    You can enter a custom interpretation approach, referencing the provided examples, select a model, and click Generate Interpretation. The system will automatically interpret the data for you.

    image

    You can stop interpretation while the result is being generated.

    image

    Adopting the result generates a data interpretation report.

    image

    If you want to modify the data interpretation approach or model for a second interpretation, click the image icon to the right of the data interpretation, make your changes, and generate a new report.

    image

  • Follow-up Q&A (⑩)

  • Feedback (⑪)

    Click image to give a thumbs-up or image to give a thumbs-down. When you give a thumbs-down, you can provide feedback.

    image

  • Copy Trace ID (⑫)

    image

Inference and interpretation methods

Methods

By default, the system uses its own models for inference and interpretation. You can choose between the system's built-in LLM and your own custom model. Select the appropriate inference and interpretation methods based on your business needs.

image

Examples

The following examples show the results for the question "What is the proportion of orders for each order level?" using different inference and interpretation methods.

  • Example 1: Use the default official inference and no data interpretation.

    The system returns the analysis process and a chart.

    image

  • Example 2: Use the built-in Qwen-Max model for both inference and data interpretation.

    The system uses the Qwen-Max model to return the inference process, data interpretation result, and a chart.

    image

  • Example 3: Use the built-in DeepSeek-R1 model for both inference and data interpretation.

    The system uses the DeepSeek-R1 model to return the inference process, data interpretation result, and a chart.

    image

Ask a follow-up question

You can use the follow-up Q&A feature to ask for more details about the previous result, for a more focused analysis. The following example shows how to do this.

Note

You can ask only one follow-up question for each main question.

  1. In the conversation interface, click Follow-up Q&A to ask a question related to the answer for "Which province has the highest sales?"image

  2. Enter a follow-up question, such as: What is the top-selling product?

    Click the 2024-04-10_11-01-42 icon in the lower-right corner of the dialog box or press Enter to send the question and get the analysis result.image

    Note

    The system automatically exits follow-up Q&A mode. If you want to ask another follow-up question, click the follow-up Q&A button again.

Conversation list

  • Click the image icon in the upper-left corner to view your Q Chat conversation history.image

  • Click the image icon to start a new Q Chat session.

    image

Mobile client display

  • Mobile micro-application configuration

    Follow the steps in the figure to enter the mobile editing interface.image

    In the editing interface, configure Q Chat for the mobile micro-application.

    image

Best practices for asking questions

  1. Add a time frame to your question for more precise results. For example:

    1. Instead of asking "sales share of each product", ask "this year's sales share of each product".

  2. To avoid ambiguity when querying multiple dimension values, use keywords such as "separately", "each", or "total" to distinguish between individual and aggregated results. For example:

    1. A query like "sales in Zhejiang and Jiangsu" or "sales from 2020 to 2023" is ambiguous. Instead, specify your intent clearly: "sales in Zhejiang and Jiangsu separately", "sales for each year from 2020 to 2023", or "the total combined sales for Zhejiang and Jiangsu".

  3. When asking for maximum or minimum values across multiple dimensions, be specific to avoid ambiguity between grouped and ungrouped results. For example:

    1. Instead of asking "Which product sold best in Zhejiang and Jiangsu?", ask a more specific question like "What is the top-selling product in Zhejiang?" or "What is the top-selling product in each province?"

    2. Instead of asking "What were the best 3 sales months last year in Zhejiang and Jiangsu?", ask "What were the best 3 sales months in Zhejiang last year?" or "What were the top 3 order months by sales for each province?"

  4. If a dimension value is ambiguous, specify the dimension explicitly in your question. For example:

    1. A question like "Rank products purchased by corporate customers by sales" can be ambiguous. The term "corporate" might be interpreted in other ways. Be more specific: "For customer type 'corporate', rank purchased products by sales."