Skip to main content
View source

Reducto

View as Markdown

A RocketRide data node that uploads each incoming document to Reducto, then emits its reconstructed Markdown text and each detected table; use it when Reducto's parsing options match the documents you need to process.

About Reducto

Reducto provides a document-parsing API for extracting content from files. This node uses the Reducto Python client to upload document bytes, request a parse, and convert the returned blocks into text and table outputs for a RocketRide pipeline.

What it does

Reducto buffers one document from the tags lane, uploads it, and calls the Reducto parse API. It builds Markdown from the returned blocks and writes each table both within that text and as a separate item on table. Pick it when you want its simple OCR/figure options or can provide its advanced enhance settings; choose a different parser when the required output is not the block-based Markdown this node reconstructs.

Lanes

Lane inLane outDescription
tagstextMarkdown reconstructed from returned content blocks.
tagstableEach returned table block, as separate Markdown content.

Configuration

The default profile uses Simple mode. Use it for the three built-in enhancement choices; switch to Advanced Mode only when you need to send raw Reducto enhance dictionaries. The simple and advanced settings are mutually exclusive in the implementation.

Advanced Mode

With Advanced Mode off, the node builds the enhance request from the three simple toggles. With it on, it ignores those toggles and reads Options, Advanced Options, and Experimental Options as Python dictionary literals. Empty fields are omitted; present dictionaries merge in that order, so a later field overrides an earlier key. Use Python syntax such as {'ocr_mode': 'agentic'}, not JSON syntax such as {"enabled": true}: validation uses ast.literal_eval and rejects a value that is not a dictionary.

Simple-mode enhancement choices

Contains Handwritten Text adds ocr_mode: 'agentic'; enable it for handwriting or small text and table-cell corrections. Contains Non-English Text adds ocr_system: 'multilingual'; enable it for non-Germanic languages or Unicode symbols. AI Summarize Figures/Images adds summarize_figures: true; leave it off when the original figure content is more useful than a generated summary. All three default to off.

In Simple mode the node always sends summarize_tables: false, regardless of the figure-summary setting. In Advanced Mode, supply any desired behavior in the dictionaries instead.

Authentication

Set API Key to a Reducto API key. Configuration validation performs a minimal in-memory upload of ping.txt; failure raises Reducto API key validation failed, so saving configuration requires access to Reducto.

Notes

Output and failure behavior

The node performs a remote parse only when processing a buffered document. It writes text or tables only when their respective output lane has a listener. If the API key is missing, upload or parsing fails, or the response cannot be read, the parser returns empty text and no tables; the instance logs the condition and emits no replacement error document.

Markdown reconstruction

Returned title, section_header, and list_item blocks become Markdown headings and bullets. Table blocks are included in the full text and emitted separately. A figure block is emitted as ordinary content unless figure summarization was enabled, in which case it is prefixed with [DIAGRAM/IMAGE SUMMARY]:.

Upstream docs

Schema

FieldTypeDescriptionDefault
reducto.Contains_Handwritten_TextbooleanContains Handwritten Text
Enables Agentic OCR mode for better handwriting recognition and small text/table cell corrections.
false
reducto.Contains_Non_English_TextbooleanContains Non-English Text
Enables Multilingual OCR system which can parse non-Germanic languages and unicode symbols.
false
reducto.Summarize_TextbooleanAI Summarize Figures/Images
Generate AI summaries for figures, diagrams, and images using vision-language models.
false
reducto.advanced_documentationnullAdvanced Parse Mode - How to
In advanced mode, you can use the full set of options from the Reducto API. For each set of options you must use and only include a python dictionary, e.g., {'key': 'value', 'flag': True}. If no information is provided for a set of options, the default values will be used. For more information on what options are available, see the Reducto API documentation at https://docs.reducto.ai/parsing/default-configurations. This page also contains examples of how to format the options fields. (In Advanced mode your configuration from Simple mode will be ignored)
null
reducto.advanced_optionsstringAdvanced Options
Advanced options for the Reducto API
reducto.api_keystringAPI Key
Your Reducto API key
reducto.experimental_optionsstringExperimental Options
Experimental options for the Reducto API
reducto.optionsstringOptions
Options for the Reducto API
reducto.parse_modebooleanAdvanced Mode
Toggle to use the advanced parse mode, and have access to the full set of options from the Reducto API.
false

Dependencies

  • reductoai