Wren Engine — 已归档

本仓库已合并至 https://github.com/Canner/WrenAI 的 core/ 目录下，现已归档（只读）。

新的 issue 和 PR → https://github.com/Canner/WrenAI/issues 完整迁移详情（路径映射、已归档模块、迁移原因）→ https://github.com/Canner/wren-engine/discussions/1592

---

Wren Engine

面向 AI 智能体的开放上下文引擎

Wren Engine 是 https://github.com/Canner/WrenAI 的开放基础：一个面向业务数据的语义化、受治理、支持智能体的上下文层。

为什么选择 Wren Engine

AI 智能体已经能够调用工具、浏览文档和编写代码。但它们仍然难以处理业务上下文。

企业数据不仅仅是数据仓库中的行。它包含定义、指标、关系、权限、血缘和意图。一个能够连接到 PostgreSQL 或 *** 的智能体，仍然无法理解贵公司中的“净收入”“活跃客户”或“管道覆盖率”的实际含义。

这不仅是我们的观点。在 a16z 的文章 Your Data Agents Need Context 中提到，数据智能体如果仅具备连接能力和 SQL 生成能力，而缺乏业务定义、事实来源上下文以及解释公司实际运营方式的操作知识，就会失效。

Wren Engine 的存在就是为了填补这一空白。

它为 AI 智能体提供了一个可推理的上下文引擎，使其能够：

• 理解模型而非原始表
• 使用可信指标而非生成 SQL
• 遵循关系而非猜测连接
• 尊重治理而非绕过治理
• 将自然语言转换为准确、可解释的数据访问

这是面向构建下一代智能体体验的团队的开源上下文引擎。

愿景

我们相信 AI 的未来不仅仅是工具调用。而是构建富含上下文的系统，使智能体能够在对业务现实的共同理解基础上进行推理、检索、规划和行动。

Wren Engine 是我们对这一未来的开源贡献。

它是 Wren AI 底层的语义和执行基础，其设计目标远超单一产品的使用场景：

• 嵌入 MCP 服务器和智能体工作流
• 连接现代数据仓库、数据库和文件系统
• 足够表达性，可通过 MDL 建模业务含义
• 足够健壮，可支持受治理的企业用例
• 足够开放，供社区扩展、集成和构建

如果说 Wren AI 是完整愿景，那么 Wren Engine 就是使该愿景具备互操作性的开放核心。

Wren Engine 的功能

Wren Engine 将业务数据转换为智能体可用的上下文。

从高层来看：

1. 使用 Wren 的语义模型和 MDL 描述您的业务领域。
2. Wren Engine 捕获智能体所需的上下文：模型、指标、关系和访问规则。
3. 分析意图并跨底层数据源规划正确的查询。
4. MCP 客户端和 AI 智能体通过简洁的接口与此上下文交互。
5. 随着业务逻辑和系统的演变，团队不断完善模型。

这是从文本到 SQL 迈向上下文感知数据智能体的实用开源路径。

这意味着您的智能体不再问“我应该查询哪个原始表？”

而是问“我需要哪个业务概念、指标或受治理的上下文片段才能正确完成此任务？”

为智能体构建者打造

Wren Engine 对开源社区特别有用，尤其是在以下工具中构建原生智能体工作流的场景：

• OpenClaw
• Claude Code
• VS Code
• Claude Desktop
• Cline
• Cursor

如果您的环境能够支持 MCP、调用 HTTP API 或嵌入语义服务，Wren Engine 可以成为智能体背后的上下文层。

使用它来支持以下体验：

• 基于可信业务定义的自然语言分析
• 能够跨受治理企业数据回答问题的 AI 助手
• 生成仪表板、报告和工作流决策的智能体
• 需要真实业务上下文而非仅模式转储的代码助手
• 基于语义模型而非临时 SQL 的内部 AI 工具

这在面向开发者的智能体环境中尤为重要，其中助手可能理解您的代码库，但仍然缺乏正确回答数据问题所需的业务上下文。

支持的数据源

Wren Engine 旨在跨现代数据栈工作，包括数据仓库、数据库和基于文件的数据源。

当前开源版本支持的连接器包括：

• Amazon S3
• Apache Spark
• Apache Doris
• Athena
• BigQuery
• ClickHouse
• Databricks
• DuckDB
• Google Cloud Storage
• Local files
• MinIO
• MySQL
• Oracle
• PostgreSQL
• Redshift
• SQL Server

• ---

• Trino

有关最新的连接模式和功能，请参阅项目文档中的连接器 API 文档。

快速开始

通过 AI 智能体使用 Wren Engine

如果您希望通过 Claude Code 或其他 AI 智能体使用 Wren Engine，请从以下资源开始：

• 安装
• 快速入门：使用 Wren Engine + Claude Code 与 jaffle_shop 对话
• 理解 Wren AI 项目结构

MCP 服务器包括：

• 用于连接和 MDL 设置的本地 Web UI
• 用于更安全智能体使用的只读模式
• 清单部署和验证工具
• 用于远程模式发现的元数据工具

学习核心概念

• 什么是上下文？
• 什么是建模定义语言（MDL）？
• Wren Engine 与 LLM 结合的优势
• Your Data Agents Need Context
• 使用 Apache DataFusion 为 AI 智能体提供语义 SQL 支持

Wren Engine 与其他数据工具的对比

人们经常将 Wren Engine 与数据目录服务（如 DataHub）、原始数据库 MCP 服务器、BI 语义工具或文本到 SQL 智能体进行比较。

简单的区别在于：

• 这些工具通常帮助智能体查找数据或生成 SQL
• Wren Engine 通过上下文引擎帮助智能体理解业务含义并生成正确的查询

许多团队会同时需要：

• 用于盘点和记录数据资产的数据目录
• 将数据转换为智能体可用上下文的 Wren Engine

其重要性在于：

• 更准确的答案，因为连接和指标是明确定义的，而非猜测的
• 更一致的答案，因为每个智能体使用相同的业务定义
• 更安全的数据访问，因为治理可以融入查询规划
• 更少的提示工程，因为上下文存在于引擎中，而非提示中

没有 Wren，智能体可能知道数据在哪里，但仍然不知道如何正确回答问题。

仓库结构

本仓库包含核心引擎模块：

支持模块包括 wren-core-legacy、example、mock-web-server 和基准测试工具。

开发者入口

• wren-core/README.md
• wren-core-py/README.md
• ibis-server/README.md
• mcp-server/README.md

本地开发

常见工作流：

# Rust 上下文引擎
cd wren-core
cargo check --all-targets

# Python + 连接器服务器
cd ibis-server
just install
just dev

# MCP 服务器
cd mcp-server
# 参见模块 README 了解基于 uv 的设置

项目状态

Wren Engine 正在开源环境中积极发展。当前重点是增强上下文引擎、执行路径和 MCP 集成，以支持实际的智能体工作流。

如果您正在构建智能体，现在是参与的好时机。

社区

• 加入我们的 *** 社区
• 提交 https://github.com/Canner/wren-engine/issues
• 探索 https://github.com/Canner/WrenAI 了解更广泛的产品愿景
• 阅读 a16z 的市场观点：Your Data Agents Need Context

Wren Engine 面向那些相信 AI 需要更好上下文而非仅更好提示的构建者。