Document processing

Turn PDFs and scanned documents into typed rows for your production systems.

Operations teams use document processing agents to move information from invoices, contracts, forms, and scans into databases, ERPs, and review queues. Agno returns validated Pydantic objects from files and images. Workflows add approvals, batch execution, retries, and schedules.

Define a Pydantic schema and pass the document through File. The agent returns a validated instance of that schema.

from typing import List, Optional

from agno.agent import Agent
from agno.media import File
from agno.models.openai import OpenAIResponses
from pydantic import BaseModel, Field


class LineItem(BaseModel):
    description: str
    quantity: Optional[float] = None
    unit_price: Optional[float] = None
    amount: Optional[float] = None


class Invoice(BaseModel):
    invoice_number: Optional[str] = Field(None, description="As printed on the invoice")
    vendor: Optional[str] = None
    invoice_date: Optional[str] = None
    due_date: Optional[str] = None
    subtotal: Optional[float] = None
    tax: Optional[float] = None
    total: Optional[float] = None
    currency: Optional[str] = Field(None, description="ISO 4217, e.g. USD, EUR")
    lines: List[LineItem] = Field(default_factory=list)


agent = Agent(
    model=OpenAIResponses(id="gpt-5.5"),
    instructions=(
        "Extract invoice fields and line items from the attached PDF. "
        "Use exactly what the document shows. If a field is missing, "
        "leave it null. Do not guess."
    ),
    output_schema=Invoice,
)

result = agent.run(
    "Extract the invoice.",
    files=[File(url="https://example.com/invoice-1042.pdf")],
).content
# Invoice(invoice_number='1042', vendor='Acme Corp', invoice_date='2026-04-12',
#         due_date='2026-05-12', subtotal=1200.0, tax=96.0, total=1296.0,
#         currency='USD', lines=[LineItem(...), LineItem(...)])

result is a validated Invoice ready for an INSERT, an ERP call, or a queue message.

Workloads

Workload	Page
Invoices, receipts, statements	Invoices and receipts
Contracts, MSAs, policies	Contracts
Resumes, applications, KYC intake	Forms and intake

Production concerns

You need to	Page
Process a folder or a queue of documents	Batch and durability
Schedule a nightly run that retries on failure	Batch and durability
Route low-confidence fields to a human	Human routing and eval
Track accuracy against a labeled golden set	Human routing and eval

Explore

Invoices and receipts

Header fields, line items, and the path from PDF to a database row.

Contracts

Parties, dates, and a clause-level breakdown for review queues.

Forms and intake

Extract nested employment, education, skills, and identity fields.

Batch and durability

Workflows over a folder, background runs, scheduled jobs with retries.

Human routing and eval

Confidence-gated approval and accuracy tracking against a golden set.

Developer Resources

• Document extraction cookbook
• Structured output
• Workflows
• Scheduler cookbook