ChartGen Data Analysis
Data analysis skill based on ChartGen API, supporting natural language-based data analysis, interpretation, and visualization.
Overview
This skill enables codeless data analysis through natural language interaction. It supports Text2SQL, Text2Data, and Text2Code analysis. Simply provide Excel/CSV files or JSON data to automatically execute data queries, data interpretation, and data visualization (ChatBI).
The skill will intelligently parse time, metrics, and analytical dimensions through conversational queries, then generate SQL queries for data, create interactive BI charts, structured analysis reports. Optimized for standardized vertical datasets, powered by enterprise-grade analytics engine for reliable results.
API Service: This skill uses the ChartGen API service hosted at chartgen.ai. All data is sent to https://chartgen.ai/api/platform_api/ for processing.
Quick Start
1. Apply for an API Key
You can easily create and manage your API Key at chartgen.ai. To begin with, you need to register for an account.
Steps:
- 1. Visit chartgen.ai and sign up for an account
- Access the API management dashboard
- Create a new API and set the credit consumption limit
- Copy the API Key for use
2. Configure Environment Variable
CODEBLOCK0
3. Run Scripts
CODEBLOCK1
Credit Rules
- - Calling a single tool consumes 20 credits
- You get 200 free credits per month for free accounts
- When credits run out, you can purchase more or upgrade your account on the chartgen.ai Billing page
Scripts Reference
| Script | Function | Use Case |
|---|
| INLINECODE1 | Data Analysis | Statistics, filtering, aggregation, calculation |
| INLINECODE2 |
Data Interpretation | Trend analysis, pattern discovery, report generation |
|
data_visualization.py | Data Visualization | Chart generation, data display |
Parameters
Common Parameters
| Parameter | Required | Description |
|---|
| INLINECODE4 | ✅ | Natural language query statement |
| INLINECODE5 |
❌ | Local file path (.xlsx/.xls/.csv), mutually exclusive with --json |
|
--json | ❌ | JSON data (string or file path), mutually exclusive with --file |
Visualization Specific Parameters
| Parameter | Description |
|---|
| INLINECODE7 | Output HTML file path (defaults to /tmp/openclaw/charts/) |
Data Format
File Format
Supports .xlsx, .xls, .csv Excel and CSV files.
Note: Only one of --file or --json is needed. If both are provided, --file takes precedence. File types support both row-metric-column data files and column-metric-row data files.
JSON Format
JSON data should be an array format, where each element is a row of data:
CODEBLOCK2
Or pass via file:
CODEBLOCK3
Usage Examples
Data Analysis
CODEBLOCK4
Data Interpretation
CODEBLOCK5
Data Visualization
CODEBLOCK6
Output Description
Data Analysis & Data Interpretation
Returns Markdown format text results, including analysis conclusions, data tables, etc.
Data Visualization
- 1. Console Output: ECharts configuration JSON
- HTML File: Can be opened in browser to view the chart
Error Handling
Common errors and solutions:
| Error Message | Cause | Solution |
|---|
| INLINECODE11 | Environment variable not set | INLINECODE12 |
| INLINECODE13 |
Request timeout | Check network connection and retry |
|
File not found | File does not exist | Check if file path is correct |
|
credits are insufficient | Insufficient credits | Recharge or contact administrator |
Technical Details
- - API Base URL: INLINECODE16
- Authentication: Header INLINECODE17
- Request Format: JSON
- Timeout: 60 seconds
- Required Environment Variable: INLINECODE18
See scripts/chartgen_api.py for implementation details.
Privacy Notice
Data sent to remote API: This skill reads your provided data files (CSV/XLSX/JSON), base64-encodes them, and sends them to the ChartGen API at https://chartgen.ai/api/platform_api/ for analysis and chart generation. Your data will leave your machine.
Recommendations:
- - Do not upload sensitive or regulated data
- Use a dedicated API key with limited scope/credits
- Review the privacy practices at chartgen.ai before use
ChartGen 数据分析
基于ChartGen API的数据分析技能，支持自然语言驱动的数据分析、解读与可视化。
概述
本技能通过自然语言交互实现无代码数据分析。支持Text2SQL、Text2Data和Text2Code分析。只需提供Excel/CSV文件或JSON数据，即可自动执行数据查询、数据解读和数据可视化（ChatBI）。
该技能将通过对话式查询智能解析时间、指标和分析维度，然后生成SQL查询语句获取数据，创建交互式BI图表和结构化分析报告。针对标准化垂直数据集进行了优化，由企业级分析引擎驱动，确保结果可靠。
API服务：本技能使用托管在 chartgen.ai 的ChartGen API服务。所有数据将被发送至 https://chartgen.ai/api/platformapi/ 进行处理。
快速开始
1. 申请API密钥
您可以在 chartgen.ai 轻松创建和管理您的API密钥。首先，您需要注册一个账户。
步骤：
- 1. 访问 chartgen.ai 并注册账户
- 进入API管理面板
- 创建新的API并设置额度消耗限制
- 复制API密钥以供使用
2. 配置环境变量
bash
export CHARTGENAPIKEY=your-api-key-here
3. 运行脚本
bash
数据分析
python scripts/data_analysis.py --query 按区域计算总销售额 --file sales.xlsx
数据解读
python scripts/data_interpretation.py --query 分析销售趋势 --file sales.xlsx
数据可视化
python scripts/data_visualization.py --query 绘制按区域划分的销售额柱状图 --file sales.xlsx
积分规则
脚本参考
| 脚本 | 功能 | 使用场景 |
|---|
| dataanalysis.py | 数据分析 | 统计、筛选、聚合、计算 |
| datainterpretation.py |
数据解读 | 趋势分析、模式发现、报告生成 |
| data_visualization.py | 数据可视化 | 图表生成、数据展示 |
参数说明
通用参数
| 参数 | 必填 | 描述 |
|---|
| --query | ✅ | 自然语言查询语句 |
| --file |
❌ | 本地文件路径（.xlsx/.xls/.csv），与--json互斥 |
| --json | ❌ | JSON数据（字符串或文件路径），与--file互斥 |
可视化专用参数
| 参数 | 描述 |
|---|
| --output, -o | 输出HTML文件路径（默认为/tmp/openclaw/charts/） |
数据格式
文件格式
支持 .xlsx、.xls、.csv 格式的Excel和CSV文件。
注意：只需提供--file或--json中的一个。如果两者都提供，--file优先。文件类型支持行指标列数据文件和列指标行数据文件。
JSON格式
JSON数据应为数组格式，每个元素代表一行数据：
json
[
{name: 产品A, sales: 1000, region: 东部},
{name: 产品B, sales: 1500, region: 北部},
{name: 产品C, sales: 800, region: 南部}
]
或通过文件传递：
bash
python scripts/data_analysis.py --query 分析数据 --json data.json
使用示例
数据分析
bash
统计计算
python scripts/data_analysis.py --query 按区域计算总销售额和平均销售额 --file sales.xlsx
数据筛选
python scripts/data_analysis.py --query 筛选销售额大于1000的产品 --file sales.xlsx
排序
python scripts/data_analysis.py --query 按销售额降序排列 --file sales.xlsx
数据解读
bash
趋势分析
python scripts/data
interpretation.py --query 分析月度销售趋势 --file monthlysales.xlsx
异常检测
python scripts/data_interpretation.py --query 查找并解释数据中的异常 --file data.xlsx
综合解读
python scripts/data_interpretation.py --query 提供此数据的综合分析及关键洞察 --file report.xlsx
数据可视化
bash
柱状图
python scripts/data_visualization.py --query 绘制按产品划分的销售额柱状图 --file sales.xlsx
折线图
python scripts/data_visualization.py --query 绘制销售趋势折线图 --file trends.xlsx
饼图
python scripts/data_visualization.py --query 绘制按区域划分的销售额饼图 --file sales.xlsx
保存到指定路径
python scripts/data_visualization.py --query 绘制散点图 --file data.xlsx -o /path/to/chart.html
输出说明
数据分析与数据解读
返回Markdown格式的文本结果，包括分析结论、数据表格等。
数据可视化
- 1. 控制台输出：ECharts配置JSON
- HTML文件：可在浏览器中打开查看图表
错误处理
常见错误及解决方案：
| 错误信息 | 原因 | 解决方案 |
|---|
| CHARTGENAPIKEY not set | 环境变量未设置 | export CHARTGENAPIKEY=your-key |
| API request timeout |
请求超时 | 检查网络连接并重试 |
| File not found | 文件不存在 | 检查文件路径是否正确 |
| credits are insufficient | 积分不足 | 充值或联系管理员 |
技术细节
- - API基础URL：https://chartgen.ai/api/platformapi/
- 认证方式：请求头 Authorization:
- 请求格式：JSON
- 超时时间：60秒
- 必需环境变量：CHARTGENAPI_KEY
实现细节请参见 scripts/chartgen_api.py。
隐私声明
发送至远程API的数据：本技能会读取您提供的数据文件（CSV/XLSX/JSON），进行Base64编码后发送至 https://chartgen.ai/api/platform_api/ 的ChartGen API进行分析和图表生成。您的数据将离开您的机器。
建议：
- - 请勿上传敏感或受监管的数据
- 使用具有有限范围/额度的专用API密钥
- 使用前请查阅 chartgen.ai 的隐私实践
