> Documentation index for agents: https://docs.rocketride.ai/llms.txt

# reducto

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 in | Lane out | Description |
| --- | --- | --- |
| `tags` | `text` | Markdown reconstructed from returned content blocks. |
| `tags` | `table` | Each 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

- [Reducto documentation](https://docs.reducto.ai/overview)

<!-- ROCKETRIDE:GENERATED:PARAMS START -->
<!-- Generated by nodes:docs-generate. Do not edit by hand. -->

## Schema

| Field | Type | Description | Default |
|---|---|---|---|
| `reducto.Contains_Handwritten_Text` | `boolean` | **Contains Handwritten Text**<br/>Enables Agentic OCR mode for better handwriting recognition and small text/table cell corrections. | `false` |
| `reducto.Contains_Non_English_Text` | `boolean` | **Contains Non-English Text**<br/>Enables Multilingual OCR system which can parse non-Germanic languages and unicode symbols. | `false` |
| `reducto.Summarize_Text` | `boolean` | **AI Summarize Figures/Images**<br/>Generate AI summaries for figures, diagrams, and images using vision-language models. | `false` |
| `reducto.advanced_documentation` | `null` | **Advanced Parse Mode - How to**<br/>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_options` | `string` | **Advanced Options**<br/>Advanced options for the Reducto API |  |
| `reducto.api_key` | `string` | **API Key**<br/>Your Reducto API key |  |
| `reducto.experimental_options` | `string` | **Experimental Options**<br/>Experimental options for the Reducto API |  |
| `reducto.options` | `string` | **Options**<br/>Options for the Reducto API |  |
| `reducto.parse_mode` | `boolean` | **Advanced Mode**<br/>Toggle to use the advanced parse mode, and have access to the full set of options from the Reducto API. | `false` |

## Dependencies

- `reductoai`

## Source

[<svg viewBox="0 0 16 16" width="15" height="15" fill="currentColor" aria-hidden="true" style="vertical-align:-0.15em;margin-right:0.35em"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg> View source](https://github.com/rocketride-org/rocketride-server/tree/develop/nodes/src/nodes/reducto)
<!-- ROCKETRIDE:GENERATED:PARAMS END -->
