Vanna icon

Vanna

认领

Vanna 是一款 AI SQL agent 框架,用于构建可直接上线的数据库助手。支持自然语言查询、多种 LLM 提供商和数据库,并提供可选的团队托管管理功能。

Vanna

概览

Vanna 是一款 AI SQL agent 和 agent 构建框架,用于让用户通过自然语言查询公司数据。首页将其定位为一种可构建并直接投入生产的 agent 方案,内置用户作用域执行、丰富的 UI 组件和配额管理。

该产品支持多种 LLM 提供商和数据库,文档展示了一个配置流程,可为所选技术栈生成可直接使用的代码。用户可以从示例笔记本或自托管设置开始,然后将框架连接到自己的数据库、agent 记忆、身份验证逻辑和服务器运行时。

功能

模型和数据库选择

Vanna 可与多种 LLM 提供商和数据库配合使用。首页列出了 Anthropic、OpenAI、Gemini 和 Ollama,以及 SQLite、PostgreSQL、MySQL、Snowflake、BigQuery 和其他数据库。

自然语言数据访问

该产品支持对数据库进行自然语言查询,并被定位为一款 AI SQL agent,帮助用户无需直接编写 SQL 即可提问。

可复用的 agent 记忆

文档展示了会存储成功的“问题到工具参数”示例的 agent 记忆,以便后续查询复用之前的交互并提升准确性。

按用户范围执行与访问控制

配置文档包含用户身份验证和访问组设置,允许在 agent 执行工具之前为不同用户分配不同权限。

托管管理功能

首页描述了可选的托管管理功能,例如可观测性、审计日志、文件存储、数据保留和托管 agent 记忆。

复制粘贴式配置与服务器设置

文档包含可直接运行的服务器示例和生成的配置代码,其中包括基于 FastAPI 的执行方式。

使用场景

  • 自助式数据库问答

    让业务或运营用户用自然语言而不是手写 SQL 来查询公司数据库。

  • 按用户范围控制的内部 agent

    构建一个面向生产的 agent,使用访问组、用户解析和工具注册,让不同用户看到不同的能力。

  • 使用示例数据或自有数据进行原型验证

    先使用示例笔记本或生成的配置代码,在将其接入更大型应用之前,先在 SQLite 或其他受支持的数据库上测试 Vanna。

  • 将 agent 使用流程运营化

    当团队需要对使用情况和记录进行更多控制时,可添加审计日志、可观测性和数据保留等托管管理能力。

Pros and Cons

Pros

  • 支持多种 LLM 提供商和数据库,便于适配不同技术栈。
  • 托管管理功能包含访问控制、可观测性、审计日志、文件存储和数据保留。
  • 提供设置指南和可直接复制粘贴的配置代码,有助于更快实施。
  • 根据定价 FAQ,可以从开源版开始,并在无需重写代码的情况下迁移到云端或企业版。

Cons

  • 公开来源并未详细说明所有工作流或集成,因此某些实现选择需要在文档中进一步确认。
  • 定价采用分层方案,企业版细节为定制化,因此团队在选择方案前需要评估限制和部署要求。

FAQ

如何开始使用 Vanna?

Vanna 的文档展示了适用于所选 LLM 提供商和数据库的可直接复制粘贴的设置代码。快速开始还提供了一个 Google Colab 示例笔记本,可使用示例数据试用 Vanna。

Vanna 可以运行在哪些环境中?

来源显示 Vanna 可与多种 LLM 提供商和数据库配合运行,并支持自托管、Vanna Cloud 和企业部署选项。

之后可以从开源版升级到付费方案吗?

定价页面说明各个套餐使用相同的核心框架,因此你可以先使用开源版本进行自托管,之后再迁移到托管云或企业部署,而无需重写代码。

Vanna 会为用户生成什么?

文档和首页显示,输出内容可能包括可直接使用的代码、SQL 执行,以及通过已注册工具进行的数据可视化,具体取决于你的配置。

Quick Facts

类别
AI agent 框架
主要用途
自然语言数据库查询
平台
具有开源、云端和企业选项的网页产品
LLM 提供商
Anthropic, OpenAI, Gemini, Ollama
数据库
SQLite, PostgreSQL, MySQL, Snowflake, BigQuery
来源域名
vanna.ai