当前位置：首页 > news >正文

Vanna 2.0：用自然语言解锁数据库智能查询

news 2026/7/5 3:38:47

Vanna 2.0：用自然语言解锁数据库智能查询

【免费下载链接】vanna人工智能驱动的数据库查询。使用RAG实现准确的文本到SQL的转换。项目地址: https://gitcode.com/GitHub_Trending/va/vanna

人工智能驱动的数据库查询革命。使用RAG技术实现精准的自然语言到SQL转换，让数据对话变得简单直观。

核心功能亮点

🎯 智能权限感知系统

Vanna 2.0最大的突破在于用户感知的权限控制。系统能够自动识别用户身份，根据权限组对查询结果进行智能过滤。不同用户看到的数据自动符合其访问权限，无需复杂的人工配置。

🎨 现代化Web组件

内置精美的<vanna-chat>组件，可直接嵌入任何现有网页。支持实时数据流、交互式表格和图表展示，让你的应用瞬间拥有专业级的聊天界面。

🔒 企业级安全保障

专为生产环境设计，提供完整的企业安全功能：

行级安全：查询结果根据用户权限自动过滤
审计日志：每个用户的每次查询都被完整记录
速率限制：通过生命周期钩子实现按用户配额控制

快速上手指南

安装Vanna

使用pip命令安装最新版本：

pip install vanna

基础配置示例

连接到SQLite数据库的简单配置：

import vanna from vanna import Agent from vanna.tools import RunSqlTool from vanna.integrations.sqlite import SqliteRunner # 设置代理和工具 llm = vanna.integrations.openai.OpenAILlmService() tools = vanna.core.registry.ToolRegistry() tools.register(RunSqlTool(sql_runner=SqliteRunner("./data.db"))) agent = Agent( llm_service=llm, tool_registry=tools )

自定义用户解析器

轻松集成现有认证系统：

class MyUserResolver(vanna.core.user.UserResolver): async def resolve_user(self, request_context): # 从cookie、JWT或会话中提取用户信息 token = request_context.get_header('Authorization') user_data = self.decode_jwt(token) # 你的现有逻辑 return vanna.core.user.User( id=user_data['id'], email=user_data['email'], group_memberships=user_data['groups'] )

技术架构深度解析

智能SQL生成流程

Vanna采用两阶段工作流程，确保SQL查询的准确性和相关性。

训练阶段：处理DDL、文档和参考SQL查询，生成嵌入向量并存储在向量数据库中。

查询阶段：接收用户问题，生成嵌入向量，从向量数据库中检索相关数据，为LLM构建提示，最终输出SQL结果。

性能优化机制

通过上下文策略显著提升SQL生成准确率：

从图表可以看出，在上下文相关示例策略下，各LLM模型都表现出最佳性能，平均准确率达到83%。

实际应用场景

数据分析应用

Vanna 2.0是构建自然语言数据分析界面的理想选择。用户可以简单地问"显示第四季度销售额"，系统就会自动生成相应的SQL查询并返回结果。

多租户SaaS应用

对于需要用户感知权限的多租户应用，Vanna 2.0提供了开箱即用的解决方案。

企业环境部署

在需要严格安全审计要求的企业环境中，Vanna 2.0的审计日志功能能够满足合规性需求。

高级功能特性

自定义工具开发

Vanna 2.0允许创建自定义工具来扩展功能。例如，发送邮件工具：

class EmailTool(vanna.core.tool.Tool): @property def name(self): return "send_email" @property def access_groups(self): return ["send_email"] # 权限检查 async def execute(self, context, args): user = context.user # 自动注入的用户信息 # 你的业务逻辑 return vanna.core.tool.ToolResult(success=True)