报表生成
自动连接业务数据库,按需提取数据并生成可视化报表,替代人工取数与制表,缩短报表交付周期。
适用场景
1
销售日报/周报自动生成:从订单库提取数据,按区域、产品线汇总并输出图表
2
财务月度经营分析:从财务系统取数,生成收入、成本、利润趋势报表
3
运营指标监控:定时从埋点库提取DAU、转化率等指标,生成看板数据
4
供应链库存报表:从ERP提取库存周转、缺货率数据,生成可视化周报
核心Prompt(安装配置用)
你是企业报表生成Agent,负责从指定数据库中提取数据并生成可视化报表。 角色设定:你是一名资深数据分析师,熟悉SQL查询、数据清洗和可视化报表设计,服务对象是企业业务与财务人员。 任务描述: 1. 根据用户给出的报表需求(指标、维度、时间范围、筛选条件),生成对应的SQL查询语句; 2. 连接目标数据库执行查询,获取原始数据; 3. 对数据进行必要的清洗、聚合和格式转换; 4. 按用户指定的图表类型(折线、柱状、饼图、表格等)生成可视化报表,并输出结构化结果。 输出格式: - 查询SQL(代码块) - 数据摘要(行数、时间范围、关键指标值) - 图表配置(图表类型、X轴、Y轴、系列) - 报表结论(3条以内业务洞察) 约束条件: - 仅执行只读查询,禁止执行INSERT/UPDATE/DELETE/DROP等写操作; - 查询必须带时间范围和LIMIT,单次返回不超过10000行; - 涉及敏感字段(手机号、身份证、薪资)需脱敏后再输出; - 若需求不明确,先向用户确认指标口径与时间范围,不得擅自假设; - 图表配色使用企业标准色,确保可读性。
所需工具 / API对接
需对接:MySQL/PostgreSQL/SQL Server等关系型数据库(只读账号);BI可视化库(ECharts或Matplotlib);企业IM推送API(钉钉/企业微信/飞书)用于报表分发;调度系统(Airflow或Cron)用于定时任务;对象存储(OSS/S3)用于报表文件存档。
安装部署步骤
11. 环境准备:确认Python 3.9+、数据库只读账号、网络连通性,执行 python --version 与 telnet db_host 3306 验证。
22. 安装依赖:pip install pandas sqlalchemy pymysql matplotlib openpyxl requests,执行 pip list 确认安装成功。
33. 配置参数:创建 config.yaml,填写数据库连接串、默认时间范围、图表输出目录、IM推送Webhook。
44. 导入Prompt:将core_prompt写入 agent_config/prompts/report_agent.md,并在Agent框架中注册该Prompt路径。
55. 连接工具API:在 tools.yaml 中配置数据库连接、可视化库、IM推送接口,运行 python test_conn.py 验证各连接可用。
66. 测试验证:执行 python run_agent.py --task "生成近7天各区域销售日报",检查SQL、数据、图表、结论是否完整正确。
77. 上线部署:用Airflow配置每日8:00定时任务,或部署为API服务(FastAPI),配置日志与告警。
88. 监控运维:设置失败重试与异常告警,每周检查查询性能与报表准确性。
配置参数
| 参数名 | 说明 | 默认值 |
|---|---|---|
db_type |
数据库类型,支持mysql/postgresql/sqlserver | mysql |
report_period |
默认报表时间范围 | 近7天 |
chart_type |
默认图表类型 | line |
max_rows |
单次查询最大返回行数 | 10000 |
push_channel |
报表推送渠道 | dingtalk |
schedule_cron |
定时任务表达式 | 0 8 * * * |
效果示例
输入:生成近7天各区域销售额趋势报表,按天汇总。
输出:
SQL:SELECT region, DATE(order_time) d, SUM(amount) amt FROM orders WHERE order_time>=DATE_SUB(NOW(),INTERVAL 7 DAY) GROUP BY region,d;
数据摘要:共42行,覆盖华东、华北、华南3区域,总销售额386万元。
图表配置:折线图,X轴为日期,Y轴为销售额,系列为区域。
结论:华东区连续3天增长;华南区周末回落明显,建议核查促销节奏。
输出:
SQL:SELECT region, DATE(order_time) d, SUM(amount) amt FROM orders WHERE order_time>=DATE_SUB(NOW(),INTERVAL 7 DAY) GROUP BY region,d;
数据摘要:共42行,覆盖华东、华北、华南3区域,总销售额386万元。
图表配置:折线图,X轴为日期,Y轴为销售额,系列为区域。
结论:华东区连续3天增长;华南区周末回落明显,建议核查促销节奏。
常见问题
Q1:数据库连接失败怎么办?
A:检查只读账号权限、防火墙白名单和连接串,执行test_conn.py定位具体错误。
Q2:生成的SQL查不到数据?
A:确认时间范围、时区和字段口径,先用简单COUNT(*)验证表是否有数据。
Q3:报表数值与业务系统不一致?
A:对比指标口径(是否含退款、是否去重),在Prompt中明确计算规则。
Q4:如何保证数据安全?
A:使用只读账号、敏感字段脱敏、查询带LIMIT、操作日志留痕。
Q5:支持多少种图表?
A:默认支持折线、柱状、饼图、表格,可通过可视化库扩展。
A:检查只读账号权限、防火墙白名单和连接串,执行test_conn.py定位具体错误。
Q2:生成的SQL查不到数据?
A:确认时间范围、时区和字段口径,先用简单COUNT(*)验证表是否有数据。
Q3:报表数值与业务系统不一致?
A:对比指标口径(是否含退款、是否去重),在Prompt中明确计算规则。
Q4:如何保证数据安全?
A:使用只读账号、敏感字段脱敏、查询带LIMIT、操作日志留痕。
Q5:支持多少种图表?
A:默认支持折线、柱状、饼图、表格,可通过可视化库扩展。
企业落地建议
建议先选1个高频报表场景(如销售日报)做试点,用只读账号接入,2-3周验证准确率与时效。部署可选轻量脚本+定时任务,或集成到现有Agent平台。成本主要为开发人力(约3-5人天)与服务器资源,若用云数据库和IM推送,月成本可控在数百元。注意事项:严格权限隔离、指标口径需业务确认、上线前做数据一致性校验、保留人工复核环节。需我们帮你落地吗?可以试试免费AI诊断→
需要我们帮你落地?
专业团队帮你从0到1部署企业AI Agent,含安装配置、定制开发、持续运营