query_tables

Answer a natural-language question over uploaded table files — one or several.

Cost class: slow.

paths is a list of selection rows — {"path": ...} for a whole file, {"path": ..., "component": <tab>} for one tab of one workbook (repeat the path to select several tabs). Every path must be a table file — a spreadsheet (xlsx, xls, xlsm, xlsb, ods) or record file (csv, tsv, parquet, jsonl, ndjson, json); a document, media, or image path is refused with invalid_request naming qa-file. Every tab is askable whatever its ingestion produced: selections whose tabs all have extracted rows are answered by the SQL engine — the answer keeps full result parquet storage outside the response and returns bounded previews plus authenticated workspace result-file citations — while a selection holding tabs with only a rendered sheet is answered by a QA agent that reads renderings and queries row extractions together (no result previews on that lane; citations quote the sheets).

component names are workbook-local — the same strings file-metadata and filtered-search publish as component, matched exact-name first, then the unambiguous sanitized alias. A name that matches nothing on its own workbook — or any component on a single-table upload (csv/jsonl/parquet), which has no named parts — is invalid_request. A selected tab with no usable content at all is reported in unavailable rather than silently dropped.