WrenAI：面向 AI 智能体的开源 GenBI 语义层与上下文层

工具定位

WrenAI 是开源生成式 BI（GenBI）引擎，目标用户是已有 AI 智能体的构建者。它作为一层接入 Claude Code、Cursor、Cline、Codex、MCP 客户端和 LangChain 等工具，而非另做一个聊天界面。

其核心思路是：数据库 schema 只告诉智能体数据在哪里，Wren 补充数据「意味着什么」——经批准的指标定义、枚举、单位、关联关系和示例，这些内容以可审阅的 YAML 与 Markdown 存放在用户自有的仓库中。

两个层面

• 语义层（MDL，建模定义语言）：描述模型、列、关系、视图、立方体与指标，与具体数仓解耦；instructions.md 和 queries.yml 承载 schema 之外的枚举、单位、批准的关联等上下文。
• AI 上下文层：包括版本控制的知识文件与本地 LanceDB 记忆索引（混合检索）。

原文给出的使用流程

原文给出三步起步方式：安装命令行工具（pip install wrenai，按需附加连接器扩展）、通过 npx skills add Canner/WrenAI 安装约 50 行的发现入口、在项目目录中让智能体完成连接配置与首次查询。之后对应「Know（补充业务上下文）—Generate（生成受治理 SQL）—Deploy（生成并部署仪表板）」的循环。

执行路径上，查询会经过 MDL 规划、dry-plan 校验、行数限制与结构化错误提示；引擎基于 Apache DataFusion，支持 BigQuery、Snowflake、PostgreSQL、ClickHouse、Redshift、Databricks、DuckDB 等 22+ 数据源。仪表板为浏览器端应用，由 wren-core-wasm 驱动，可部署到 Vercel 或 Cloudflare Pages。

开源与商业边界

仓库内的引擎（MDL 语义层、受治理的 text-to-SQL、MCP 服务器、CLI、22+ 连接器）为 Apache-2.0 许可，可自托管。行级/列级安全与访问控制、GenBI 界面与嵌入 API、场景化 AI 工具、高级审计与 SLA、VPC 与隔离部署等属于商业版本（Wren AI Cloud 或自托管 Enterprise Plus）。

使用限制

原文明确说明：若只需对单个 CSV 做一次性图表，或愿意让智能体在无治理条件下猜测 SQL，则不适合使用。文中提及的旧版 Docker 式聊天优先产品保留在 legacy/v1 分支，不再有新功能与安全修复。文中「下一步」列出的能力属于计划方向，不是现有功能。