Vanna 是一款开源项目：开源的文本转 SQL 框架，基于 RAG 训练。

这篇写给负责在团队里引入它的人：账号、权限、数据和费用怎么管。

上线前

  • 固定版本号并记录配置。
  • 只在内网暴露服务或加上认证。
  • 设置日志与资源监控。
  • 订阅仓库的版本发布与安全公告。
  • 准备回滚方案。

制度与培训

  • 写一页使用规范：能做什么、不能上传什么、产出由谁负责。
  • 准备 3 个标准任务的示例，如「图表建议」「数据清洗方案」
  • 设立反馈渠道，收集好用的提示词和踩过的坑。
  • 每季度复查一次账号、权限与费用。

给成员的标准示例

图表建议

准备材料：一组需要汇报的数据。

根据这些数据推荐合适的图表类型，说明理由，并指出容易误导读者的画法（如截断坐标轴）。

交付前确认：指出了误导风险。

数据分级建议

  • 公开信息：可以直接使用。
  • 内部信息：在企业账号内使用，避免个人账号。
  • 机密信息：脱敏后使用或禁止使用。
  • 受监管数据（身份证号、病历、财务明细等）：除非有明确合规方案，否则不要输入。

补充练习

指标异动解读

适用情况：手头有一个突然下降的业务指标时。

日活本周下降了，请列出可能原因的排查清单，按「数据问题 / 产品变化 / 外部因素」分类，每项写明需要查看的数据。

验收标准：先排查数据本身问题。

评测大模型应用

适用情况：手头有一批真实用户问题和应用回答时。

为这批回答设计评测：定义 4 个评分维度，写出评分标准，抽取 20 条进行人工打分，并统计各维度的问题类型。

交付前确认：评分标准清晰可复用。

自然语言问数

输入：一张销售明细表。

请基于这张表回答：上个季度销售额最高的 3 个地区是哪些？与前一季度相比变化多少？请同时给出你使用的计算方法或 SQL，便于我复核。

检查点：给出了可复核的计算过程。

常见问题：生成的 SQL 运行报错

提供准确的表结构和字段说明，先在测试库运行。

常见问题：问数结果看似合理但错误

准备几道已知答案的问题做抽检。

常见问题：图表结论被过度解读

区分相关与因果，在报告中标注假设。

概念补充：异常检测

自动发现偏离正常范围的数据点。

概念补充：语义层

把业务指标定义统一管理，让 AI 查询时口径一致。

适合人群：软件工程师

软件工程师可以用 Vanna 处理代码阅读与重构、测试与排错等工作。需要注意：不要把密钥和未开源代码上传到未授权工具，合并前审阅每处改动。

适合人群：数据分析师

数据分析师可以用 Vanna 处理取数与 SQL、清洗与可视化等工作。需要注意：确认指标口径，敏感数据脱敏后再交给 AI 处理。

适合人群：HR 与招聘

HR 与招聘可以用 Vanna 处理岗位描述撰写、面试题与评估表等工作。需要注意：简历筛选不得以性别、年龄等因素做歧视性判断，候选人信息需妥善保管。

写在最后

涉及个人信息、商业机密或受监管数据时，先确认 Vanna 的数据处理条款，再决定能否使用。

所有示例输出均为示意，不代表真实统计或效果承诺；请以自己的测试结果为准。

延伸阅读