All Products
Search
Document Center

DataWorks:ChatBI sessions

Last Updated:Mar 26, 2026

ChatBI works like a professional data analyst embedded in your browser. Ask a question about your dataset in plain language, and ChatBI handles the rest — querying the data, building visualizations, and delivering a report with findings and charts.

Before you begin

Make sure you meet the following requirements before starting a session.

RequirementDetails
Serverless resource groupA Serverless resource group must exist in the region where you use ChatBI.
DatasetA dataset must be created before you can start a session.
MySQL data sourceChatBI may generate SQL that performs a full table scan. On large tables, this increases database load. Use a secondary database for the dataset to avoid affecting your production environment.
Hologres data sourcePlan your data tables carefully. Use partitioned tables to prevent query timeouts caused by large query ranges.

Start a session

  1. Log on to Alibaba Cloud and access the ChatBI intelligent data insight page from your browser. Select the region where your DataWorks resource group and datasets are located.

    China (Hangzhou)

    China (Shanghai)

    China (Shenzhen)

    China (Hong Kong)

    China (Chengdu)

    China (Beijing)

    China (Zhangjiakou)

    Indonesia (Jakarta)

  2. In the navigation pane on the left, click New Chat. In the session window, click Select Dataset.

  3. Enter your analysis question in the input box.

    image

How it works

After you submit a question, ChatBI runs through the following stages automatically.

Understand the question

ChatBI interprets your question by rewriting and expanding it, standardizing semantics, organizing the query logic, and decomposing the task into steps.

image

Identify the target table

ChatBI searches the dataset for relevant tables and explains why each table was selected.

image

Generate an execution plan

Based on the complexity of your question, ChatBI generates one or more SQL statements. You can copy and collapse the SQL code to inspect it.

image

Run the query

The generated SQL runs automatically and retrieves the query results.

image

Generate a report

ChatBI produces a report from the query results, including a title, an overall description, visualizations, and conclusions.

Important

This report is generated by artificial intelligence (AI) and is for reference only. The report content in this topic uses sample data for demonstration purposes.

image

The report also includes a detailed data file as an attachment. Click the file name to view the data, or click image to download it.

image

Share the report

At the end of the report, click Share. You can generate an HTML link or export the report as a PDF file.

image