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
信用规则
- - 每次调用单个工具消耗 20 个信用点
- 免费账户每月可获得 200 个免费信用点
- 信用点用尽后，您可以在 chartgen.ai 计费页面 购买更多信用点或升级账户
脚本参考
| 脚本 | 功能 | 使用场景 |
|---|
| 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 的隐私政策
