wren-engine

为AI智能体提供业务语义理解与数据访问的上下文引擎

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:wren-engine。
它的用途是:为AI智能体提供业务语义理解与数据访问的上下文引擎
完整的 Skill 内容见:https://321skill.com/skills/wren-engine/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我分析一下本季度各区域的净收入趋势,并对比去年同期数据。”集成了Wren Engine的智能体不会直接去猜测‘净收入’对应哪张表的哪个字段,而是基于你预先定义好的业务模型,理解‘净收入’是一个已计算好的可信指标,‘区域’是一个维度,并自动关联正确的数据表和过滤条件,生成准确且可解释的SQL查询,返回业务上正确的分析报告。

介绍

Wren Engine旨在解决AI智能体在处理企业数据时缺乏业务上下文的核心痛点。企业数据不仅仅是数据库中的原始表格,还包含了业务定义、指标、关系、权限和业务意图。仅能连接数据库并生成SQL的智能体,无法真正理解“净收入”、“活跃客户”等业务概念,导致分析结果不准确或无法执行。

该引擎通过一个语义层,将原始数据表映射为业务模型和可信指标。开发者或数据团队可以定义数据模型(MDL),描述业务实体、度量、维度和它们之间的关系。AI智能体(如通过MCP集成)可以查询这个语义层,将自然语言问题转换为基于业务理解的、可解释的SQL查询,从而获得准确、合规的数据结果。

它非常适合正在构建或集成AI智能体的后端开发、全栈开发和智能体开发者,尤其是那些需要让智能体理解复杂业务数据场景的团队。数据分析师也可以利用它来构建更智能、更易用的数据查询界面。

需要注意的是,该仓库已被归档并合并至WrenAI项目。虽然其核心思想和技术仍然有效,但新的功能开发、问题反馈和代码贡献应转向新的主仓库。对于希望直接使用完整产品(包括UI)的用户,建议关注WrenAI项目;而对于希望深入研究或集成其上下文引擎核心能力的开发者,仍可参考此仓库的架构与代码。

核心特点

与仅提供数据库连接或SQL生成能力的工具不同,Wren Engine的核心是构建一个可被AI智能体“理解”的业务语义层,它预先定义了数据背后的业务含义、关系和治理规则,使智能体能基于业务概念而非原始表结构进行推理和查询。

注意事项

该仓库已归档,不再接受新的功能开发或问题修复,需转向WrenAI主项目;且它本身是一个需要集成和配置的引擎,不适合寻求开箱即用、带完整用户界面的终端用户。

常见问题

Wren Engine和WrenAI是什么关系?

Wren Engine是WrenAI项目的核心语义引擎部分,现已被合并至WrenAI仓库的`core/`目录下,原仓库归档。

我还能使用Wren Engine吗?

可以,代码仍可参考和运行,但新功能开发和问题处理需在WrenAI项目中进行。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/wren-engine/raw/index.md 读取 wren-engine 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。