/alibabacloud-quickbi-smartq

name: alibabacloud-quickbi-smartq
description: |
  Quick BI-SmartQ skill with multiple data analysis capabilities:
  1. **File Q&A**: Upload Excel/CSV files for intelligent analysis via Quick BI API
  2. **Dataset Q&A**: Natural language queries on Quick BI platform datasets, with automatic intelligent table selection and matching
  3. **Document Parsing**: Parse PDF/Word/Excel/CSV/images, extract text, and support extracting key fields to generate structured Excel
  4. **Dashboard Skill Generation**: Auto-convert QuickBI dashboards into data query skills
  5. **Data Insight**: Deep data insight analysis on Quick BI datasets
  6. **Data Report**: Auto-generate professional data reports based on analysis results
  Use when users mention data analysis, smart Q&A, querying data, file analysis,
  document parsing, dashboard skills, data insight, or data reports.
compatibility: "tools: [python3, pip, browser], runtime: [requests, pyyaml, matplotlib, numpy]"
metadata:
  label: Quick BI-SmartQ
  version: "1.3.0"

Quick BI-SmartQ — QuickBI Data Analysis Assistant

One entry point covering all QuickBI data analysis capabilities. Automatically routes to the corresponding module based on user intent — no manual selection required.

Scope

**Does:**

• Automatically identify user intent and route to the corresponding data analysis module
• Perform natural-language analysis on user-uploaded Excel/CSV files via the Quick BI API (File Q&A)
• Perform natural-language query analysis on Quick BI platform datasets, with automatic intelligent table selection and matching (Dataset Q&A)
• Parse PDF/Word/Excel/CSV/images, extract text, and support extracting key fields to generate structured Excel (Document Parsing)
• Auto-convert QuickBI dashboards into data query skills (Dashboard Skill Generation)
• Perform deep insight analysis on datasets (Data Insight)
• Auto-generate professional data reports based on analysis results (Data Report)

**Does NOT:**

• Use pandas/openpyxl/csv or similar libraries to read files locally for analysis in Q&A scenarios
• Require users to manually choose a module or provide internal parameters such as cubeId
• Perform tasks unrelated to QuickBI data analysis

Image Output Rules (MUST READ)

This skill produces chart images (PNG) as **core deliverables** for the user. **Images MUST be displayed to the user — they are the primary output of the skill.**

**When the script output contains `` image references**, the Agent MUST:

1. **Include every `` verbatim** in the reply body — this is the ONLY way the user can see the chart 2. **MUST NOT read/view chart PNG files** with `Read`, `showFile`, `present`, or any file-reading tool 3. **Single-response delivery** — wait for the script to fully complete, then compose ONE reply containing: images → conclusions → interpretation. MUST NOT split across multiple responses 4. **Pre-delivery self-check** — before sending, verify that every `` from the script output appears in the reply body

**The Markdown image syntax `` is the sole delivery mechanism for chart images.**

Task Routing

Automatically determine intent based on user input and route to the corresponding module for execution.

Routing Decision Table

| User Intent | Routed Module | Reference Document | |------------------------|--------------------------|------------------------------| | Uploaded Excel/CSV file, wants to query specific metrics or answer specific data questions (e.g. TOP N, comparison, filtering) | File Q&A | [module-chat-file.md](references/chat/module-chat-file.md) | | No file uploaded, wants to query/analyze specific metrics in platform datasets | Dataset Q&A | [module-chat-dataset.md](references/chat/module-chat-dataset.md) | | Uploaded multiple files (PDF/Word/images etc.) or selected a folder, wants to query specific data questions (e.g. TOP N, comparison, filtering) | Document Parsing → File Q&A | [module-document-parser.md](references/document/module-document-parser.md) → [module-chat-file.md](references/chat/module-chat-file.md) | | Uploaded PDF/Word/images or other unstructured documents, or selected a folder, wants to parse all file contents or extract fields | Document Parsing | [module-document-parser.md](references/document/module-document-parser.md) | | Provided a QuickBI dashboard URL, wants to generate a query skill | Dashboard Skill Generation | [module-dashboard.md](references/dashboard/module-dashboard.md) | | Uploaded Excel file, wants deep interpretation/insight/trend analysis of data (not generating a report document) | Data Insight | [module-data-insight.md](references/insight/module-data-insight.md) | | Provided a QuickBI dashboard / data portal URL, wants deep interpretation/insight/trend analysis of the dashboard | Data Insight (Dashboard mode) | [module-data-insight.md](references/insight/module-data-insight.md) | | Uploaded multiple files (PDF/Word/images etc.) or selected a folder, wants deep interpretation/insight/trend analysis of data (not generating a report document) | Document Parsing → Data Insight | [module-document-parser.md](references/document/module-document-parser.md) → [module-data-insight.md](references/insight/module-data-insight.md) | | Wants to generate a report/analysis report/review report, regardless of whether files are uploaded | Data Report | [module-data-report.md](references/report/module-data-report.md) |

Routing Priority Rules

When user intent may match multiple modules, determine by the following priority:

1. **"Report" keyword takes priority**: When user intent contains keywords like "report", "review", "summary report", "analysis report", **ALWAYS route to the Data Report module**, regardless of whether files are uploaded. Data Report module has higher priority than File Q&A and Data Insight. 2. **"Interpret", "insight", "trend" keywords**: When user wants to understand data meaning, discover trends, or gain insights, route to t