extract-structured-data
Configure extract-structured-data parameters, input/output bindings and lineage.
Extract schema-bounded structured fields from unstructured text columns.
Install
Install the Transforms bundle, then select the extract-structured-data capability on a pipeline transform node. Runtime entrypoint: transforms/extract-structured-data.ts. The installed capability must be enabled and pass preflight.
Configure
Execution: AI-based. Declared runtime support: supported.
Parameters
| Field | Type | Required | Details |
|---|---|---|---|
sourceFields | array | Yes | Text-bearing fields to combine for extraction. Enter one field per line. Items: string. |
extractedFields | array | Yes | Structured fields to extract. Items: object. |
outputPrefix | string | No | Optional prefix added to each extracted output field. |
instructions | string | No | Optional extraction guidance. |
confidenceField | string | No | Field that stores extraction confidence for each row. Default: "extractionConfidence". |
rationaleField | string | No | Field that stores extraction rationale for each row. Default: "extractionRationale". |
View the complete contract for nested parameter shapes, defaults, named bindings and lineage.
Bindings
- Input
in: Input (required) - Output
out: Output
Verify the result
Create a small input with known values that exercise extract-structured-data and supply the required parameters above. Validate, save and run the pipeline. Inspect the output records and compare row counts and changed fields with the input. Check the run’s errors and evidence before accepting a conversational summary.
Review the confidence and rationale fields where supplied. Include ambiguous examples and inspect the result; model output is not an observed business fact.
Lineage and changes
Lineage mode: row_preserving. This capability declares one output row per input row in the same order. Verify that downstream evidence still refers to the correct source row.
Changing parameters changes the computation. Review the saved pipeline revision before rerunning it. Publishing a new plugin version and editing node parameters are different changes.
FAQ
Why does validation fail?
Check required parameters, the installed capability version, runtime support and the named input/output bindings. A missing nested field may be visible only in the full contract.
Is this a standalone MCP tool?
It is a plugin capability used by a pipeline, not a new top-level MCP tool with this operation name. An assistant can inspect, validate and execute the pipeline through the MCP reference.