> ## Documentation Index
> Fetch the complete documentation index at: https://agents.nanonets.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Document Splitter

> Analyzes a PDF and produces a splitting schema (page groups, filenames, rationale).

Analyzes a PDF and produces a splitting schema (page groups, filenames, rationale). Display name **"Document Splitter"**. On by default for new agents.

The user (or a later step) reviews the schema before pages are actually split. Password-protected PDFs: `file_utils` `unlock` first.

## Authentication and enablement

No integration. Default-on.

## Inputs

* `file_url` (required): the PDF.
* `splitting_criteria` (required): natural-language split rules and per-document fields to extract.
* `document_id_regex` (optional): when each document starts on a page with a printed id (`INV-[0-9]{6}`). OCR misreads are repaired; do not loosen the pattern for them.
* `markdown_url` (optional): if `document_parser` already ran, pass its markdown to avoid a second parse. Still pass `file_url` for citations and the real split.
* `exclude_blank_pages`, `validation_rules`, `reviewers` — optional.

## Output

A schema of page groups with suggested filenames and `document_id` when regex matching is used.

## Limits and side effects

* Analysis + schema generation; actual page split follows the schema path.
* Validation failures can pause the task for review.

## Expected errors

* Missing `file_url` / `splitting_criteria`.
* Locked PDF.
* Unreadable file.