AskTable

AskTable CLI：让 AI 助手帮你管理数据

AskTable 团队
AskTable 团队 2026年3月18日

AskTable CLI：让 AI 助手帮你管理数据

我们发布了什么

AskTable 现已支持命令行工具（CLI），让 Claude Code、Cursor 等 AI 助手可以直接操作你的数据源、查询数据、管理权限。

一句话理解：在 AI Agent 时代，CLI 是 AI 与数据分析能力之间的标准接口。

对你有什么价值

1. 让 AI 助手拥有数据分析能力

当你在 Claude Code 中说"帮我查一下上个月的销售数据"，AI 可以直接调用 AskTable CLI 完成查询，无需你手动打开网页、登录、输入问题。

2. 自动化你的数据工作流

3. 用代码管理数据权限

通过脚本批量创建角色、配置权限策略，告别手动点击。

如何开始使用

第一步：安装和认证

安装

npm install -g @datamini/asktable-cli

安装完成后，你可以在任何地方使用 

asktable
命令。

配置认证（推荐方式）

asktable auth login
# 输入你的 API Key，配置会保存到本地

或者使用环境变量：

export ASKTABLE_API_KEY="your-api-key"
export ASKTABLE_API_URL="https://cloud.asktable.com"

第二步：基础操作

查看你的数据源

asktable ds list

查询数据

asktable query <bot_id> "上个月销售额最高的产品是什么"

查询结果会自动下载为 CSV 文件，保存在 

/tmp/asktable/
目录。

上传新数据

# 创建数据源
asktable ds create --name "销售数据" --engine excel

# 上传文件
asktable ds upload <datasource-id> sales.xlsx

# 同步元数据
asktable ds meta sync <datasource-id> --wait

常用场景

场景 1：快速查询数据

# 创建 Bot（绑定数据源）
asktable bot create --name "销售助手" --datasource <datasource-id>

# 查询
asktable query <bot-id> "各部门的销售额排名"

查询结果自动保存为 CSV，你可以直接用 Excel 打开或继续处理。

场景 2：配置数据权限

# 创建策略：员工只能看自己的数据
asktable policy create \
  --name "员工自查" \
  --permission allow \
  --datasources <datasource-id> \
  --rows-filter '{"*.*.employee_id": "{{employee_id}}"}'

# 创建角色并绑定策略
asktable role create --name "普通员工" --policies <policy-id>

# 带角色查询
asktable query <bot-id> "我的加班情况" \
  -r <role-id> \
  -V employee_id=59114541

场景 3：自动化数据同步

# 定时脚本：每天同步数据源元数据
#!/bin/bash
asktable ds meta sync <datasource-id> --wait
echo "元数据同步完成: $(date)"

给 AI Agent 使用

如果你在使用 Claude Code、Cursor 等 AI 助手，可以让它们直接调用 AskTable CLI。

示例对话：

你：帮我查一下上个月销售额最高的 5 个产品

Claude Code：
$ asktable query <bot-id> "上个月销售额最高的 5 个产品" --json

结果已保存到 /tmp/asktable/xxx.csv
前 5 名产品是：
1. 产品 A - ¥1,234,567
2. 产品 B - ¥987,654
...

关键参数：

完整命令速查

数据源管理

asktable ds list                    # 列出所有数据源
asktable ds get <id>                # 查看详情
asktable ds create --name <name> --engine <engine>
asktable ds upload <id> <file>      # 上传 Excel/CSV
asktable ds meta sync <id> --wait   # 同步元数据

查询

asktable query <bot-id> "<question>" [-r <role-id>] [-V key=value]

角色和权限

asktable role list                  # 列出所有角色
asktable role create --name <name> --policies <id1,id2>
asktable policy create --name <name> --permission allow --datasources <ids>

Bot 管理

asktable bot list                   # 列出所有 Bot
asktable bot create --name <name> --datasource <id>

对话管理

asktable chat create --bot <id> [-r <role-id>]
asktable chat send <chat-id> "<question>"

完整命令文档请参考：AskTable CLI 文档

总结

AskTable CLI 让你可以：

立即开始：

asktable auth login
asktable ds list

有问题？欢迎在 GitHub 提 Issue 或加入我们的社区讨论。