⚡️ GenBI(生成式商业智能)支持使用自然语言查询任意数据库,可在数秒内生成精准的SQL(文本转SQL)、图表(文本转图表)及基于人工智能的深度洞察。
WrenAI 是一个开源的生成式商业智能(GenBI)代理,旨在让用户使用自然语言直接与数据库对话。该项目通过内置的语义层理解数据库结构,将用户提出的“用中文查询上个月的销售额”这类问题,自动转换为精准的SQL查询语句,并能在数秒内生成对应的数据图表和AI驱动的业务洞察报告。它支持连接PostgreSQL、BigQuery、DuckDB等十多种数据源,并可灵活选用OpenAI、Anthropic、Gemini等多种大语言模型作为引擎。其核心价值在于大幅降低数据分析的技术门槛,使业务人员无需掌握SQL也能快速获取数据见解,同时也为开发者提供了API,以便将智能查询能力嵌入到自己的应用或SaaS产品中。
💡 应用场景
最适合让非技术用户通过自然语言直接查询和分析多源数据,并快速集成到现有应用中的场景。
业务人员自助分析
问题:业务人员需要分析数据但不懂SQL,依赖技术团队写查询导致分析效率低下。
方案:业务人员直接用自然语言提问,WrenAI自动生成SQL并返回图表和洞察,实现自助数据分析。
示例:市场经理问“上个月各渠道的转化率对比如何?”,系统自动生成SQL查询并返回柱状图及趋势分析。
快速构建数据应用
问题:开发者需要为内部系统或SaaS产品添加自然语言查询数据的功能,但开发成本高。
方案:通过WrenAI的API直接集成文本转SQL和图表生成能力,快速构建智能数据查询功能。
示例:在CRM系统中集成WrenAI API,让销售团队直接问“本季度Top 10客户是谁?”并实时展示图表。
跨数据库统一查询
问题:企业数据分散在多个数据库(如PostgreSQL、BigQuery、MySQL),查询需要分别写SQL且语法不同。
方案:WrenAI支持多种数据源,通过语义层统一建模,用户用自然语言即可跨库查询。
示例:用户问“合并销售库和用户库,分析高价值用户的购买行为”,系统自动关联多表并生成跨库查询SQL。
实时数据报告生成
问题:制作周期性数据报告需要手动编写SQL、制作图表并撰写分析结论,耗时耗力。
方案:输入分析需求,WrenAI一次性生成SQL查询结果、可视化图表和AI撰写的洞察摘要。
示例:每周运营报告只需输入“生成上周用户活跃度报告”,系统自动输出SQL结果、趋势图和AI总结的关键发现。
📊 项目信息
- 语言
- TypeScript
- Stars
- ⭐ 13,897
- Forks
- 1,506
- 今日新增
- +89
- 排名
- #7
- 收录
- 总榜
- 趋势日期
- 2026年2月4日
🏷️ 标签
5分钟上手 WrenAI
通过本指南,您将在5分钟内使用Docker快速部署WrenAI,并体验用自然语言查询示例数据库的完整流程。
🖥️ 操作系统
⚙️ 运行环境
🔧 工具
📝 操作步骤
克隆项目并进入目录
获取WrenAI的最新代码
克隆仓库
$ git clone https://github.com/Canner/WrenAI.git进入项目目录
$ cd WrenAI配置环境变量
设置必要的API密钥和配置
复制环境变量模板
$ cp .env.example .env启动WrenAI服务
使用Docker Compose一键启动所有服务
后台启动所有容器
$ docker-compose up -d访问Web界面
打开浏览器访问WrenAI的Web界面
连接示例数据库
使用内置的示例数据源快速体验
体验自然语言查询
用中文或英文提问,查看AI生成的SQL和图表
✅ 验证成功
确认WrenAI已正常运行并能处理自然语言查询
- ✓浏览器能正常访问 http://localhost:3000
- ✓成功登录到管理界面
- ✓能连接示例数据库并看到表结构
- ✓输入自然语言问题后能返回SQL查询和图表
⚡ 快速提示
🔍 常见问题排查
❓ 端口3000被占用
→ 修改docker-compose.yml中的端口映射,如将"3000:3000"改为"3001:3000",然后访问http://localhost:3001
❓ Docker容器启动失败
→ 运行'docker-compose logs'查看具体错误,常见原因是内存不足或端口冲突
❓ 无法连接示例数据库
→ 检查容器状态'docker-compose ps',确保所有服务都正常运行。可以尝试'docker-compose down && docker-compose up -d'重启服务
❓ 查询返回错误或无结果
→ 检查.env中的API密钥配置是否正确,或尝试使用更简单的问题如"显示所有产品"
🎯 下一步
连接自己的数据库
在Web界面中添加真实的数据源,如PostgreSQL或MySQL
配置语义层
定义业务指标和关联关系,提升查询准确性
探索API集成
查看API文档,将WrenAI集成到自己的应用中
加入社区
访问Discord社区获取帮助和最新动态


