在终端和脚本里使用 CLI

npm install --global @datamini/asktable-cli

装好后 asktable 命令可用，asktable --help 列出全部命令组。

交互式登录会依次问 API Key 和 Server URL：

asktable auth login

非交互场景直接把全局参数带上：

asktable auth login --api-key YOUR_API_KEY --server https://<你的 AskTable 站点>

登录成功后配置写到当前用户的 ~/.config/asktable/config.json，键名是 api_key 和 api_url。用 asktable auth status 查看当前生效的 Key（只显示前 5 位加 ***）和 Server；asktable auth logout 清掉本地配置。

不把 Key 写进文件，用环境变量注入：

export ASKTABLE_API_KEY='YOUR_API_KEY'
export ASKTABLE_API_URL='https://<你的 AskTable 站点>'

取值优先级从高到低是：命令行 --api-key / --server → 环境变量 ASKTABLE_API_KEY / ASKTABLE_API_URL → 配置文件 → 内置默认 https://api.asktable.com。私有部署必须显式给 Server，否则会打到云端。

query 是提问的唯一入口。不指定会话时它新建一个对话、发消息、轮询等分析跑完，再输出回答和 conversation_id：

asktable query "你的数据问题" \
  --data-agent <agent_id> \
  --json

--data-agent 和 --datasources 二选一即可；--datasources 用逗号分隔多个数据源 ID：

asktable query "你的数据问题" --datasources ds_xxxxxxxx --json

轮询间隔 1 秒，最多等 120 秒；超时会报 对话 <id> 响应超时（120s）。

把上一步输出的 conversation_id 带上，就在同一个会话里追问：

asktable query "你的追问" \
  --conversation <conversation_id> \
  --json

需要行级权限时传入角色和角色变量，变量可重复传：

asktable query "你的数据问题" \
  --data-agent <agent_id> \
  --role <role_id> \
  --role-variable dept_id=D001 \
  --json

常用命令组：

删除类命令默认会问一次确认，加 --yes 跳过。完整参数以 asktable --help 和各子命令的 --help 为准。

asktable get-skill 会把一份教 AI 编程助手使用 asktable 的说明文件打印出来：

asktable get-skill

把输出保存成 markdown 文件放进编程助手的 skill 目录，它就能用自然语言驱动这套命令。注意这里的“Skill”是给编程助手看的 CLI 使用说明，和智能体上挂的技能（分析方法）是两回事。

在网页里也能拿到同样的引导：「设置」 → 「API-Key」页面顶部有「在 AI Agent 中使用」折叠区，里面直接给出这句话，复制发给 Agent 即可。