Skip to content

vanna

项目核心内容总结:

功能
Vanna 2.0 是一个将自然语言转换为 SQL 查询并生成数据洞察的工具,支持实时流式返回表格、图表、SQL 代码和自然语言总结,具备企业级安全功能(如行级权限控制、审计日志)。

使用方法

  1. 快速入门:通过预置的 <vanna-chat> 网页组件嵌入现有页面,无需开发聊天界面。
  2. 配置:集成自定义数据库(如 PostgreSQL、MySQL 等)和认证系统(如 JWT、OAuth)。
  3. 部署:支持 FastAPI/Flask 框架,提供生产级接口(如 /api/vanna/v2/chat_sse)。

主要特性

  • 用户感知:所有操作(SQL 过滤、权限控制)基于用户身份自动执行。
  • 流式响应:实时返回表格、图表和进度更新。
  • 企业安全:行级权限、审计日志、速率限制。
  • 灵活兼容:支持主流 LLM(如 Anthropic、Google Gemini)、数据库和前端框架(React/Vue)。
  • 可扩展:自定义工具(如发送邮件)、生命周期钩子、LLM 插件(如缓存)。

适用场景
多租户 SaaS、企业数据分析、需权限控制的 BI 应用、需嵌入网页的实时数据交互场景。