Vanna 2.0：将提问转化为数据洞察

自然语言 → SQL → 答案。 现已支持企业级安全性和用户感知权限。

https://github.com/user-attachments/assets/476cd421-d0b0-46af-8b29-0f40c73d6d83

Vanna2 Demo

2.0 版本更新内容

🔐 全链路用户感知 — 查询会根据用户权限自动过滤

🎨 现代 Web 界面 — 美观的预构建 <vanna-chat> 组件

⚡ 流式响应 — 实时展示表格、图表和进度更新

🔒 企业级安全 — 行级安全、审计日志、速率限制

🔄 生产就绪 — 支持 FastAPI 集成、可观测性及生命周期钩子

从 0.x 版本升级？ 请查阅迁移指南 | 变更记录

快速开始

使用示例数据尝试

快速开始 (Quickstart)

配置

配置 (Configure)

Web 组件

<vanna-chat 
  server-url="http://localhost:8000" 
  api-key="your-api-key">
</vanna-chat>

使用您现有的 Cookie/JWT，支持 React、Vue 或原生 HTML。

您将获得什么

使用自然语言提问，即可获得：

1. 流式进度更新

2. SQL 代码块（默认仅对“管理员”用户可见）

3. 交互式数据表

4. 图表（Plotly 可视化）

5. 自然语言总结

所有内容均实时流式传输至您的 Web 组件。

为什么选择 Vanna 2.0？

✅ 立即上手

生产级聊天界面
支持自定义数据库 Agent
可嵌入任何网页

✅ 企业级安全性

全链路用户感知 — 身份信息贯穿系统提示词、工具执行及 SQL 过滤 行级安全 — 查询根据用户权限自动过滤 审计日志 — 追踪每个用户的查询以满足合规性 速率限制 — 通过生命周期钩子设置每用户配额

✅ 内置美观的 Web UI

预构建 <vanna-chat> 组件 — 无需自己开发聊天界面 流式表格与图表 — 丰富的组件化展示，不仅是文本 响应式且可定制 — 支持移动端、桌面端、亮色/深色主题 框架无关 — 支持 React、Vue、原生 HTML

✅ 适配您的技术栈

任意 LLM： OpenAI、Anthropic、Ollama、Azure、Google Gemini、AWS Bedrock、Mistral 等 任意数据库： PostgreSQL、MySQL、Snowflake、BigQuery、Redshift、SQLite、Oracle、SQL Server、DuckDB、ClickHouse 等 您的身份验证系统： 自带身份验证（Cookie、JWT、OAuth Token 等） 您的框架： FastAPI、Flask 等

✅ 可扩展且具指导性

自定义工具 — 继承 Tool 基类进行扩展 生命周期钩子 — 支持配额检查、日志记录、内容过滤 LLM 中间件 — 缓存、提示词工程（Prompt Engineering） 可观测性 — 内置链路追踪与指标统计

架构

Vanna2 Diagram

工作原理

sequenceDiagram
    participant U as 👤 用户
    participant W as 🌐 <vanna-chat>
    participant S as 🐍 您的服务器
    participant A as 🤖 Agent
    participant T as 🧰 工具

    U->>W: "查看第四季度销售额"
    W->>S: POST /api/vanna/v2/chat_sse (附带身份验证)
    S->>A: User(id=alice, groups=[read_sales])
    A->>T: 执行 SQL 工具 (用户感知)
    T->>T: 应用行级安全
    T->>A: 过滤后的结果
    A->>W: 流式传输: 表格 → 图表 → 总结
    W->>U: 展示 UI 界面

核心概念：

用户解析器 (User Resolver) — 您可以定义如何从请求（Cookie、JWT 等）中提取用户身份。
用户感知工具 (User-Aware Tools) — 工具会根据用户的群组权限自动校验访问权限。
流式组件 (Streaming Components) — 后端将结构化的 UI 组件（表格、图表）流式传输到前端。
内置 Web UI — 预构建的 <vanna-chat> 组件可自动渲染所有内容。

生产环境集成您的 Auth 系统

以下是将 Vanna 集成到现有 FastAPI 应用及身份验证系统的完整示例：

from fastapi import FastAPI
from vanna import Agent
from vanna.servers.fastapi.routes import register_chat_routes
from vanna.servers.base import ChatHandler
from vanna.core.user import UserResolver, User, RequestContext
from vanna.integrations.anthropic import AnthropicLlmService
from vanna.tools import RunSqlTool
from vanna.integrations.sqlite import SqliteRunner
from vanna.core.registry import ToolRegistry

# 您现有的 FastAPI 应用
app = FastAPI()

# 1. 定义您的用户解析器 (使用您现有的 Auth 系统)
class MyUserResolver(UserResolver):
    async def resolve_user(self, request_context: RequestContext) -> User:
        # 从 Cookie、JWT 或 Session 中提取
        token = request_context.get_header('Authorization')
        user_data = self.decode_jwt(token)  # 您现有的逻辑

        return User(
            id=user_data['id'],
            email=user_data['email'],
        )

vanna-ai/vanna