@antv/ava

中文文档
4.0.0发布于 2026/11/04MITTypeScriptESM + CJS近 30 天下载 1.2万

AI-原生视觉分析框架

中文使用文档
文档目录23 节
  1. 为什么是AVA?
  2. 统一数据访问
  3. * * * 已按部就班地回答问题
  4. 智能可视化
  5. * 当地执行
  6. 已公布的基准
  7. 代理人整合
  8. 开始
  9. 使用量
  10. 1. 装入
  11. 2. 探索
  12. 3. 建议
  13. 4. 分析
  14. 5. 视觉
  15. QQ 连接您的数据
  16. 基准
  17. 更多使用AVA的方法
  18. 与代理使用
  19. 从 CLI 使用
  20. 资源
  21. 捐款
  22. 页:1
  23. 许可证

AVA,AI-原生视觉分析

AVA logo

Website Documentation AI Agent Try Sive GitHub llms

阿富汗 (单位:千美元)AVA examples 视觉分析(Visual Analytics)是一款为更方便的视觉分析而设计的技术框架. A 类 代表人工智能、自动化和增强; 瓦纳 代表视觉分析.

[注] 将AVA想作"熊猫AI"为JavaScript. 💬📊🤖

它为您的应用程序和AI代理带来了自然语言数据分析和可视化.

为什么是AVA?

统一数据访问

连接 文件和数据库 通过一个接口.

数据来源

* * * 已按部就班地回答问题

检查 查询和结果 每一个答案后面.

可信的分析 ∗∗

智能可视化

获取图表 您的问题和数据。 。 。 .

可视化 −

* 当地执行

选择 分析结果 和它使用的模型终点.

执行发动机

已公布的基准

对照 参考答案 在公布的试验条件下.

基准 +

代理人整合

你的经纪人的理由; AVA 执行 数据工作流程.

代理一体化 +

开始

与节点.js 22.13+安装AVA 4.0:

npm install @antv/ava@4

使用量

下载 销售量 并配置您的模型 :

import { AVA } from '@antv/ava';

const ava = new AVA({
  llm: {
    model: '<your-model>',
    apiKey: '<your-api-key>',
    // baseURL: '<your-provider-api-url>',
  },
});

1. 装入

await ava.source({ type: 'csv-file', options: { path: './sales.csv' } });

[注] 数据预览

240行中的前3行, 选定的列 :

顺序( d)产品销售
2025-01-01 (英语)监视器224.10 联合国
2025-01-02 (中文(简体) )办公室主席页:1
2025-01-04 (英语)监视器2 191.20 (中文(简体) )

2. 探索

检查结构和数据质量,然后添加 商业定义数字 :

const schema = await ava.schema();
const profile = await ava.profile({ metrics: ['row_count', 'null_count'] });
await ava.semantic(undefined, () => ({
  description: 'Use the sales column for amounts after discounts and order_date for monthly comparisons.',
}));

[注] 分析背景

A. 背景情况细节
结构data: 12个栏
质量240行;缺少1行 region 缺少1个 quantity
语义sales 在折扣后; 每月比较使用 order_date

3. 建议

const suggestions = await ava.suggest(3);

[注] 建议的问题 (实例)

  • 2025年1月至2月销售情况如何变化??
  • 哪些产品对销售下降贡献最大?
  • 销售额和利润如何因地区而异?

4. 分析

const result = await ava.analyze(
  'Compare January and February 2025 sales by product. Show both months and the change, ordered by the largest decline.'
);

[注] 分析结果

销售总额下降 43.94%,由一位 16 092.10 (中文(简体) ) 笔记本电脑销售量下降.

9个产品中的前3个:

产品1月销售2月销售额变动
手提电脑19,688.10 (英语)3 596.00 (中文(简体) )- 16,092.10岁
常设股9,655.80 (韩语)5 546.10 (中文(简体) )-4,109.70岁
监视器6 536.25 (中文(简体) )4 731.00 (中文(简体) )- 1 805.25岁

5. 视觉

const chart = await ava.visualize({
  query: 'Plot the sales change by product from January to February 2025 as a bar chart.',
  data: result.data,
});

[注] 图表预览

Sales change by product from January to February 2025, with decreases in red and increases in green.

电源 GPT - 视频。 。 。 .

QQ 连接您的数据

CSV
简历
JSON
贾森
Parquet
公园
Excel
埃克塞尔
Text
文本
Feishu Bitable
飞须可选
Tencent Docs
十美分医生
SQLite
SQL 点
MySQL
MySQL 数据
PostgreSQL
邮递SQL
SQL Server
SQL 服务器
MongoDB
蒙戈DB
Supabase
苏巴基地
ClickHouse
点击之家

[TIP] 缺少数据源? 💡🛠️

打开一个问题 • 妇女 提交拉动请求

基准

我们根据既定基准评价AVA,以衡量其数据分析的准确性和效率.

DataBench and Spider2-Lite evaluation results comparing raw data, schema and profile, and semantic context.

评价和报告

更多使用AVA的方法

代理和CLI工作流程运行于macOS或Linux上的Node.js 22.13+上.

与代理使用

问你的人工智能经纪人:

Install the AVA skill with `npx skills add antvis/AVA`, then follow its setup instructions.

代理设置指南 →

从 CLI 使用

从终端装入并分析数据 :

ava source ./sales.csv
ava analyze '<dataset-id>' 'Compare January and February 2025 sales by product.'

见 CLI 指南 为设置和命令.

资源

捐款

欢迎捐款。 包括测试、实例和具有新特征的文件.

运行 npm test 测试您的变化。 模型辅助测试,复制 .env.example 改为 .env 并添加您的模型设置.

页:1

维兹利特 -?),一作陈克同,字克同,孙克同,F.,许克同,X.,陈克同,Z.,王克同,J.同和曹克同,N.,2021. VizLinter:用于数据可视化的Linter和Fixer框架. IEEE 视觉和计算机图形交易, 第28(1)页, 第206-216页.

QQ (探索可视化设计的类型) 2022(3),149-152 (英语).

许可证

麻省理工学院

版本与发布记录

@antv/ava 共发布 58 个版本,首次发布于 2022/11/20;过去 12 个月发布了 15 个版本。

版本发布日期距今
4.0.0latest2026/11/042 天前
4.0.0-beta.5beta2026/11/023 天前
4.0.0-beta.42026/10/307 天前
4.0.0-beta.32026/10/2610 天前
4.0.0-beta.22026/10/2611 天前
4.0.0-alpha.6alpha2026/10/1917 天前

关于 @antv/ava 的常见问题

@antv/ava 是什么?

AI-原生视觉分析框架

如何安装 @antv/ava?

在项目目录运行 npm install @antv/ava,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ava,可以用 npx ava 直接运行。

@antv/ava 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@antv/ava 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@antv/ava 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.13.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@antv/ava 可以商用吗?

@antv/ava 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@antv/ava 的下载量有多少?

根据 npm 官方下载统计,@antv/ava 在 2026/10/06 – 2026/11/04 这 30 天内被下载 11,809 次,日均约 394 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@antv/ava 还在维护吗?

最新版本 4.0.0 发布于 2026/11/04(2 天前);至今共发布 58 个版本,其中过去 12 个月发布了 15 个;首次发布于 2022/11/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。