Vanna AI
的使用方法、功能与可解决的业务课题
添加书签
Vanna AI是什么？
一款从自然语言问题生成准确 SQL 的开源（MIT）Text-to-SQL 框架。用数据库的 DDL、文档与 SQL 示例训练后，它通过智能体式检索生成可执行的 SQL。目前为「Vanna 2.0（The SQL Agent）」，具备按用户的行级控制与 Web 聊天 UI；开源核心免费，托管的 Vanna Cloud 收费。支持 Postgres、Snowflake、BigQuery 等主流数据库与 OpenAI、Anthropic 等 LLM。
可解决的业务课题
「Vanna AI」的服务详情
什么是 Vanna AI
Vanna AI（ヴァンナエーアイ）是一款从自然语言问题生成准确 SQL 的开源（MIT）Text-to-SQL 框架。只要先用数据库的 DDL（表结构）、文档与 SQL 示例对其「训练」，它便能针对中文或英文的问题，通过智能体式检索（RAG）生成可在该数据库上执行的 SQL。目前它正以「Vanna 2.0（The SQL Agent）」的形态，向具备用户权限控制与 Web 聊天 UI 的方向演进。
Vanna 的核心是「基于自家表结构，把问题→SQL→答案串联起来」。 开源核心（pip install vanna）免费，可嵌入 Flask/FastAPI，并通过 <vanna-chat> 这一 Web 组件嵌入内部应用。2.0 增加了按用户的行级控制（例如薪资仅人事可见）、审计日志、限流等企业功能，以及托管的 Vanna Cloud。需注意：开源仓库已于 2026 年初归档（只读），开发主线已转向 Vanna Cloud。
把 Web 组件插入既有应用，把 Python 服务器加入既有基础设施。它在把用户权限贯穿全局的同时，可用任意 LLM 与数据库运行 Text-to-SQL。
使用方法
先训练，再提问，然后嵌入。
训练
把 DDL、文档与过往 SQL 示例登记到 Vanna。
提问
用自然语言提问，即生成可执行的 SQL。
执行·可视化
执行 SQL，用表格或图表查看结果。
嵌入
用 Web 组件嵌入内部应用，并贯穿权限。
开源核心免费且可自托管，LLM 与数据库可自行选择。若需要更偏运营的管理功能或托管，可使用 Vanna Cloud。此外，官方开源仓库自 2026 年初已归档，此后主开发在 Cloud 一侧。
主要功能
01自然语言→SQL 生成（RAG）
用 DDL、文档与 SQL 示例「训练」，针对问题生成面向自家数据库的 SQL。智能体式检索会引出相关信息以提升精度，结果可实时以表格·图表返回。
02用户权限与嵌入式 UI
从既有 Cookie/JWT 解析用户，按角色与行级控制访问（例如薪资仅人事可见）。可通过 <vanna-chat> 的 Web 组件插入内部应用，并与 Flask/FastAPI 集成。
03广泛的数据库·LLM 支持与开源
支持 PostgreSQL·MySQL·Snowflake·BigQuery·Redshift·Oracle·SQL Server 等主流数据库，以及 OpenAI·Anthropic·Gemini·Ollama·Bedrock 等 LLM。MIT 许可的核心免费且可自托管，并具备审计日志·限流等运营功能。
价格
开源核心免费。托管的 Vanna Cloud 为下列月付（按年计费省 20%）。
| 方案 | 月付 | 主要内容 |
|---|---|---|
| Vanna Core（开源） | $0 | MIT 许可·自托管·自备 LLM/数据库 |
| Explorer | $50 | 每天 20 个问题·管理功能·API·邮件支持 |
| Team | $500 | 每天 300 个问题·部署支持·当日支持 |
| Enterprise | 需咨询 | 问题无限·本地部署支持·SAML SSO 等 |
开源核心免费（MIT），LLM 与数据库的使用费由各自承担。金额以美元计且会变动，最新信息请见官方价格页（截至 2026 年 8 月）。
与其他 Text-to-SQL·BI 的区别
Vanna 的特点在于，它是一个可用自家表结构与 SQL 示例训练、并能以任意 LLM 与数据库运行 Text-to-SQL 的开源框架。相比把 SQL 请求丢给通用聊天，或手写 SQL，其优势在于贴合自家数据的精度，以及易于嵌入内部应用。
| 维度 | Vanna | 向通用聊天要 SQL | 手写 SQL |
|---|---|---|---|
| 精度 | 借自家表结构训练易于提升 | 未共享表结构易出错 | 依赖个人 |
| 嵌入 | 借 Web 组件轻松 | 每次复制粘贴 | — |
| 权限 | 支持行级控制 | 无 | 视实现而定 |
每次把 SQL 请求丢给通用聊天，以及手写 SQL，是它的比较对象。对于希望把对自家数据库的自然语言查询嵌入内部应用的开发团队，Vanna 是一个有力的选择。
本页信息基于 2026 年 8 月的官方网站公开信息。最新规格与价格请以官方网站为准。
