vanna
项目核心内容总结:
功能
Vanna 2.0 是一个将自然语言转换为 SQL 查询并生成数据洞察的工具,支持实时流式返回表格、图表、SQL 代码和自然语言总结,具备企业级安全功能(如行级权限控制、审计日志)。
使用方法
- 快速入门:通过预置的
<vanna-chat>网页组件嵌入现有页面,无需开发聊天界面。 - 配置:集成自定义数据库(如 PostgreSQL、MySQL 等)和认证系统(如 JWT、OAuth)。
- 部署:支持 FastAPI/Flask 框架,提供生产级接口(如
/api/vanna/v2/chat_sse)。
主要特性
- 用户感知:所有操作(SQL 过滤、权限控制)基于用户身份自动执行。
- 流式响应:实时返回表格、图表和进度更新。
- 企业安全:行级权限、审计日志、速率限制。
- 灵活兼容:支持主流 LLM(如 Anthropic、Google Gemini)、数据库和前端框架(React/Vue)。
- 可扩展:自定义工具(如发送邮件)、生命周期钩子、LLM 插件(如缓存)。
适用场景
多租户 SaaS、企业数据分析、需权限控制的 BI 应用、需嵌入网页的实时数据交互场景。