Skip to main content
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.