Agentic Modes

r-1 handles general-purpose accuracy improvements for text, tables, figures, and page layouts natively. Use agentic processing with r-1 when your workflow needs a custom prompt for a specific content type or advanced chart extraction. Agentic processing runs additional model steps and adds latency.

r-1 is currently in preview and is the default for all new Parse pipelines. Existing legacy pipelines can continue using promptless agentic scopes. Review r-1 configuration compatibility before migrating an existing configuration.

Basic Usage

Add an entry to the agentic array for each scope that needs customized processing. Each entry must include a custom prompt or enable advanced chart extraction.

result = client.parse.run(
    input=upload.file_id,
    enhance={
        "agentic": [
            {
                "scope": "table",
                "prompt": "Preserve domain-specific notation such as <0.01, ±, and N/A exactly as written."
            },
            {
                "scope": "figure",
                "advanced_chart_agent": True
            }
        ]
    }
)

const result = await client.parse.run({
  input: upload.file_id,
  enhance: {
    agentic: [
      {
        scope: 'table',
        prompt: 'Preserve domain-specific notation such as <0.01, ±, and N/A exactly as written.'
      },
      {
        scope: 'figure',
        advanced_chart_agent: true
      }
    ]
  }
});

curl -X POST https://platform.reducto.ai/parse \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "reducto://your-file-id",
    "enhance": {
      "agentic": [
        {
          "scope": "table",
          "prompt": "Preserve domain-specific notation such as <0.01, ±, and N/A exactly as written."
        },
        {
          "scope": "figure",
          "advanced_chart_agent": true
        }
      ]
    }
  }'

You can configure more than one scope in a request, but only one entry per scope.

Agentic modes are available in the Python SDK, Node.js SDK, and via cURL. The Go SDK does not yet support agentic modes.

Custom Prompts

Custom prompts tell Reducto how to interpret or represent content for your use case. Pages that need a custom prompt run through the matching agentic pipeline. Other pages continue through r-1.

Text Scope

Text-scoped custom prompts apply to form regions, such as key-value fields. r-1 handles general body text natively.

enhance={"agentic": [{"scope": "text", "prompt": "Preserve account numbers and dates exactly as written."}]}

enhance: { agentic: [{ scope: 'text', prompt: 'Preserve account numbers and dates exactly as written.' }] }

"enhance": {"agentic": [{"scope": "text", "prompt": "Preserve account numbers and dates exactly as written."}]}

Table Scope

Table-scoped custom prompts control how Reducto encodes domain-specific table content.

enhance={"agentic": [{"scope": "table", "prompt": "Preserve domain-specific notation such as <0.01, ±, and N/A exactly as written."}]}

enhance: { agentic: [{ scope: 'table', prompt: 'Preserve domain-specific notation such as <0.01, ±, and N/A exactly as written.' }] }

"enhance": {"agentic": [{"scope": "table", "prompt": "Preserve domain-specific notation such as <0.01, ±, and N/A exactly as written."}]}

Table Mode

The mode option controls where Reducto applies the table custom prompt. It defaults to "default".

Mode	Behavior
`"default"`	Selectively applies customized table processing where it is likely to help.
`"max"`	Applies customized processing to every table in the job.

enhance={
    "agentic": [{
        "scope": "table",
        "mode": "max",
        "prompt": "Preserve domain-specific notation exactly as written."
    }]
}

enhance: {
  agentic: [{
    scope: 'table',
    mode: 'max',
    prompt: 'Preserve domain-specific notation exactly as written.'
  }]
}

"enhance": {
  "agentic": [{
    "scope": "table",
    "mode": "max",
    "prompt": "Preserve domain-specific notation exactly as written."
  }]
}

Figure Scope

r-1 generates a short description for each figure natively. Add one figure-scoped custom prompt when your workflow needs a use-case-specific interpretation.

enhance={"agentic": [{"scope": "figure", "prompt": "Describe the relationships between components in this diagram."}]}

enhance: { agentic: [{ scope: 'figure', prompt: 'Describe the relationships between components in this diagram.' }] }

"enhance": {"agentic": [{"scope": "figure", "prompt": "Describe the relationships between components in this diagram."}]}

Advanced Chart Extraction

Use advanced_chart_agent when you need structured numerical data from charts. Reducto runs the separate chart extraction agent and augments the r-1 result.

enhance={"agentic": [{"scope": "figure", "advanced_chart_agent": True}]}

enhance: { agentic: [{ scope: 'figure', advanced_chart_agent: true }] }

"enhance": {"agentic": [{"scope": "figure", "advanced_chart_agent": true}]}

For supported chart types and response details, see Chart Extraction.

Legacy Agentic Processing

Existing legacy Parse pipelines can continue using promptless agentic scopes as general-purpose accuracy enhancements.

Promptless scope	Legacy behavior
`text`	Adds a vision-language model pass for text and form regions.
`table`	Adds a vision-language model pass to reconstruct table structure.
`figure`	Adds enhanced figure processing. `summarize_figures` must also be enabled.

Do not carry promptless scopes into an r-1 configuration. r-1 handles these general improvements natively. With r-1, text and table scopes require a custom prompt. Figure scopes require a custom prompt or advanced_chart_agent.

Legacy Figure Summarization

For legacy Parse, summarize_figures uses a separate model to generate generic figure descriptions. It defaults to true.

enhance={"summarize_figures": True}

enhance: { summarize_figures: true }

"enhance": {"summarize_figures": true}

r-1 generates figure descriptions natively and ignores this setting.

When to Use Agentic Processing

Situation	Configuration
General parsing, including handwriting, complex tables, and figures	No agentic configuration with r-1
Use-case-specific instructions for form regions	Text scope with a custom prompt
Domain-specific table representation	Table scope with a custom prompt
Use-case-specific figure interpretation	Figure scope with a custom prompt
Structured numerical data from charts	Figure scope with `advanced_chart_agent`
General-purpose accuracy enhancement on an existing legacy pipeline	Promptless legacy scope

Latency

Customized agentic processing and advanced chart extraction run additional model steps and add latency. Pages without a matching custom prompt continue through r-1 without those additional steps. Customized agentic processing does not add cost to r-1 processing.

Get Started

Developer Tools

Core Functions

Workflows and Pipelines

Configurations

Reference

Components

Enterprise Resources

Security and privacy

On-premise Resources

Basic Usage

Custom Prompts

Text Scope

Table Scope

Table Mode

Figure Scope

Advanced Chart Extraction

Legacy Agentic Processing

Legacy Figure Summarization

When to Use Agentic Processing

Latency

​Basic Usage

​Custom Prompts

​Text Scope

​Table Scope

​Table Mode

​Figure Scope

​Advanced Chart Extraction

​Legacy Agentic Processing

​Legacy Figure Summarization

​When to Use Agentic Processing

​Latency

Basic Usage

Custom Prompts

Text Scope

Table Scope

Table Mode

Figure Scope

Advanced Chart Extraction

Legacy Agentic Processing

Legacy Figure Summarization

When to Use Agentic Processing

Latency