excel_query
查询 / 过滤 / 分组聚合 Excel,返回**实际数据行(JSON)**供 AI 直接分析(1 credit/次)。
取数工具,区别于 excel_to_chart(出图)和 excel_inspect(只看结构)。典型用法:
· 各地区销售额合计:group_by=["地区"], measures=["销售额"], agg="sum"
· 销量 Top5 商品:group_by=["商品"], measures=["销量"], agg="sum", sort_by="销量", descending=true, limit=5
· 每类别多少行:group_by=["类别"], agg="count"
· 筛失败订单明细:filters=[{"column":"状态","op":"eq","value":"失败"}]
返回 {ok, sheet, mode, columns, total_rows, matched_rows, returned_rows, truncated, rows[]}。
失败自动退款。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agg | No | 聚合方式 sum/avg/count/min/max/median(默认 sum;count=数每组行数、无需 measures) | |
| limit | No | 最多返回多少行(取前 N / Top-N);硬上限 1000 | |
| sheet | No | 目标工作表名;缺省第一个 sheet。先用 excel_inspect 看列名 | |
| columns | No | 明细模式:只返回这些列;缺省返回全部列 | |
| file_id | No | 已上传的 Excel 文件 ID(与 data_base64 二选一) | |
| filters | No | 行过滤条件(AND 组合),每项 {column, op, value}。op 可选:eq/ne/gt/ge/lt/le/contains/in/notnull/isnull。例:[{"column":"地区","op":"eq","value":"华东"},{"column":"金额","op":"ge","value":1000}] | |
| sort_by | No | 按哪一列排序(可为分组后的 measure 或 count 列) | |
| group_by | No | 分组维度列。给了就进聚合模式:按这些列分组,对 measures 求 agg | |
| measures | No | 聚合模式:要统计的数值列;缺省=所有数值列 | |
| descending | No | 降序排序(取 Top-N 常用 true) | |
| data_base64 | No | Excel(.xlsx) 内容 base64(与 file_id 二选一) |