Skip to main content
On the graph, add Extract tables. On an agent, open Files and turn Extract tables on. Extract tables reads tables from one file already stored on this Instance (upload, Telegram, mail, webhook, or an Agent). Catalog line: structure-extract tables from an artifact. View results is a markdown summary, not every row. Tables stay with the file. Put them in State with Import from a file and the same File id. Inbound CSV/XLSX/XLS can become State on the Trigger instead: Inbound files.

How it runs

1

Resolve File id

One opaque id. See File id.
2

Find tables

CSV, XLSX, and XLS: one table per sheet, in this step. PDF: Docling; the step waits up to Wait ms. A long PDF can still be running when that wait ends. Calling this step again with the same File id continues that extract.
3

Write the summary

Status, counts, optional warning/error, a short Sample, optional Document text. Same File id later reuses the extract. If the summary is still queued or running, run again or raise Wait ms.

Input

Inspector Settings. Empty-field rules for the Graph: Previous nodes. This inspector has no Insert value; you can type {{…}}. On an Agent Tool, both fields can be Agent decides or Fixed. On a Graph node you type the values.

File id

Empty does not use the previous node’s Result — this node fails. Connecting List files without filling this field still fails: list Result is a catalog, not one id. Use the Instance file id, the id in a Photos / Files array, or artifactId in this step’s own summary. Not the filename (rates.csv), not Message: Files / Photos as a JSON array, not this step’s Result markdown. Agent decides: the model can take the id from Files list or this turn’s attachments. Fixed / Graph: paste one id, or a placeholder that expands to only that id (for example {{Input}} when Test input is the id).

Output

On the next node, Previous nodes lists Extract tables: Result ({{Extract tables.text}} while the name is unique).
engine is tabular (CSV/XLSX/XLS) or docling (PDF). Document text is non-table prose in the summary. Read it before mapping records. Sample is a few rows per table, same column names import will write — do not copy them into Save records.

After this step

Extract tables → Import from a file (Collection, Replace collection). Journey: Tables into State.