返回 AI 工具目录

Vanna.AI

开发框架人工精选最近核验 2026年7月23日

Vanna.AI 是一个开源的 Text-to-SQL 智能体框架,让用户用自然语言向企业数据库提问并自动生成 SQL 与查询结果。其做法是把库表结构、文档与历史 SQL 存入向量库,检索后交给大模型生成查询,属于检索增强(RAG)式取数。框架以 Python 库形式提供,内置 FastAPI 路由与前端聊天组件,可对接 OpenAI、Anthropic、Gemini、Ollama 等模型及 PostgreSQL、MySQL、Snowflake、BigQuery 等多种数据库。官方另有托管的 Vanna Cloud,提供访问控制、审计日志与向量存储等企业能力。开源仓库已于 2026 年 3 月归档为只读,后续演进主要在云端产品。

定价开源部署自托管、本地运行、SaaS 云服务国内可达国内可达性待核验许可MIT

解决什么问题

  • 业务与运营人员无需写 SQL 即可从数据库取数
  • 把表结构、文档、历史查询用向量检索喂给模型生成 SQL
  • 支持多轮追问与图表、表格的流式返回
  • 按用户权限过滤查询结果,降低越权取数风险

适合

  • 团队想让非技术人员自助查库、看数
  • 已有明确的库表结构与可沉淀的历史 SQL
  • 需要私有部署、模型与数据库可自选的取数方案
  • 希望在自有网页嵌入自然语言问数组件

不适合

  • 依赖开源框架长期迭代的场景,仓库已归档为只读
  • 表结构混乱或缺乏训练样本时生成准确率不稳
  • 对生成 SQL 零容错的强一致报表仍需人工复核
  • 需要开箱即用企业管控时要改用商业版 Vanna Cloud

如何接入

  • Python 库,pip 安装后作为后端服务运行
  • 内置 FastAPI 路由与网页聊天组件
  • 模型侧支持 OpenAI、Anthropic、Gemini、Ollama 等
  • 数据侧支持 PostgreSQL、MySQL、Snowflake、BigQuery 等

已知限制

  • 开源仓库 2026 年 3 月已归档,只读不再更新
  • 生成 SQL 的准确性依赖训练数据质量,需人工校验
  • 企业级管控与审计集中在商业 Cloud,非开源版
  • 默认模型多为海外服务,国内使用需评估数据出境

接入与使用事实

部署方式
自托管、本地运行、SaaS 云服务
实现语言
Python、TypeScript
中文界面
待确认
中文文档
待确认
定价方式
开源
许可证
MIT
国内可达性
国内可达性待核验
可达性观察
待补充

权限、依赖与维护信号

这些字段记录公开可见信号,不等同于安全审计结论。

权限信号

暂无公开信号。

依赖信号

暂无公开信号。

维护信号

暂无公开信号。

公开来源与证据

  1. 代码仓库仅作事实索引

访问官网