Skip to content

Document Actions ​

A customer sends in a PDF invoice mid-chat, and instead of putting them on hold while you manually key in the numbers, your agent reads it, pulls the line items, and continues the conversation without missing a beat. That's what the Extract Document action is for.

This page covers the two document actions (Extract Document and Upload Document) and the built-in PDF, spreadsheet and report capabilities. You'll learn how to attach each to your AI Agent, how to pick the right extraction mode, and when to use the Document Processing node instead.

It's the conversational counterpart of the Document Processing node: that node is a deterministic step in a flow, while this is a tool the agent chooses to call when a document shows up mid-conversation. Both share the same extraction engine and the same document-type catalog.

Like every action, Extract Document attaches to the AI Agent's Action port, and the agent decides when to use it.

Adding the action ​

  1. Open your agent under Build → Agents.

  2. Click the + on the AI Agent's Action port. Under Documents pick one of:

    • Extract Document: the AI decides what to pull. You can focus it with an instruction.
    • Detect Document Type: the AI picks the document type (invoice, resume, medical report…) at call time and extracts that type's fields.
    • A specific document type, such as Medical Report, Invoice / AP, Resume / ATS, Contract / Legal, Product Catalog, Financial Statements, Insurance Claim, Compliance / Audit, RFP / Tender, or Research Paper. This pins the node to that type's fields.

    These are all the same action with a different starting setup. You can change the mode later in the panel.

  3. In Instruction, tell the agent when to use it, for example "When the customer shares an invoice, extract its details before answering questions about it."

  4. Check the How to extract mode (below). The agent only ever supplies the document. Everything else is set by you on the node.

The Extract Document panel: Instruction, How to extract set to Documented fields, and Document type set to Invoice / Accounts Payable.

Extract Document — Options ​

FieldWhat it doesOptionsDefaultShown when
Tool NameHow the AI refers to this tool. Blank → derived from the node label.
InstructionTell the AI WHEN to call this tool, WHAT inputs/payload to pass, and WHAT it returns — so it can decide whether and how to use the action. Blank → a generic default for the action.
How to extractDocumented = our curated fields for a domain (fixed, typed). AI decides = pull everything the AI finds. Your own = define your own field table.Documented fields (our domain schema) · AI decides (comprehensive) · Your own fieldsai_decides
Let the agent pick the domainThe agent chooses which document type to apply per call (invoice / medical / contract / …) instead of a fixed one.falseHow to extract is Documented fields (our domain schema)
Document typeWhich domain schema to apply — Invoice, Medical report, Contract, Resume, Product catalog, …How to extract is Documented fields (our domain schema)
Focus the extraction (optional)Optionally narrow the comprehensive extraction — fields, tables, values with units/ranges/flags, an interpretation. Leave blank to pull everything the AI finds.How to extract is AI decides (comprehensive)
Fields to extractDefine the fields to pull out of every document.How to extract is Your own fields
Extract a list (many rows)Return one row per subject the document describes (e.g. one per line item).falseHow to extract is Your own fields
Also return the raw extracted textReturn the full OCR/parsed text alongside the structured data.false

A summary row under Document type shows how many fields and table columns that type returns. The model that performs the extraction can be chosen on the AI Model card — it defaults to the platform's recommended model.

The Instruction field shapes tool use

Like every action, Extract Document carries a required Instruction field. It becomes the description the agent reads when deciding whether and how to call the tool. Say when to use it and what it returns.

Worked example — processing a lab report at Acme Diagnostics ​

Setup: Asha, an admin at Acme Diagnostics, adds the Extract Document action to her patient-intake agent. She sets How to extract to Your own fields, lists fields like patient_name, test_name, result_value, unit, and reference_range, and turns on Extract a list (many rows) so the agent returns one row per test rather than a single object. Her Instruction reads: "When the customer shares a lab report PDF, extract all test results before responding."

Action: Priya, a customer, sends a PDF of her recent blood panel in the chat.

Result: The agent calls Extract Document, gets back a structured list of test rows, and immediately replies: "I can see your haemoglobin is 11.2 g/dL, which is slightly below the reference range of 12–16 g/dL. Would you like to book a follow-up appointment?"

What just happened: The agent spotted the file, called the action automatically based on Asha's Instruction, and used the typed results to give Priya a specific, accurate answer — no copy-pasting, no manual lookup.

Upload Document ​

Upload Document (under Actions → Memory in the picker) saves a document into a customer's file. It appears on that customer's Documents tab under Customers, and it's searchable when an agent later answers questions about that customer.

The Upload Document panel: Instruction, Customer Identity, Document source, Document name and Event date.

FieldWhat it doesOptionsDefaultShown when
Tool NameHow the AI refers to this tool. Blank → derived from the node label.
InstructionTell the AI WHEN to call this tool, WHAT inputs/payload to pass, and WHAT it returns — so it can decide whether and how to use the action. Blank → a generic default for the action.
Customer IdentityHow to identify the customer to attach the document to.
Document SourceWhere the document comes from: a URL or a conversation file ref. Map it fixed / from AI / from workflow data.
Document name (optional)
Event date (optional)ISO date the document pertains to.

Leave Customer Identity fields unticked to attach the document to the customer in the current conversation. Document Source is filled From AI, a Fixed value, or From workflow data.

Saving happens in the background: the document is stored straight away and becomes searchable a moment later.

PDF, spreadsheet and report creation ​

Creating a PDF, a spreadsheet, or a longer structured report isn't a node you add. These are built-in capabilities of every AI Agent, and you switch them on per channel in the AI Agent's Advanced → Built-in capabilities:

Built-in capabilities on the AI Agent: Create a PDF, Create a spreadsheet, Write a report, Hand off to a human, Search past conversations and Schedule a follow-up, each with a checkbox per channel, including the messaging apps.

CapabilityWhat the agent can doDefault
Create a PDFBuild a PDF and give the customer a link.Off
Create a spreadsheetBuild a spreadsheet of data and give the customer a link.Off
Write a reportWrite a longer structured document with headings.Off
Hand off to a humanSays on which channels a hand-off may be offered. The hand-off itself exists only when the agent's Operator node sets one up.Allowed on every channel
Search past conversations · Schedule a follow-upNot document capabilities — listed in the same place. See AI Agent Node.Off

Each row has a checkbox per channel — WhatsApp, Phone, Web, SMS, Email, Mobile and each messaging app (Telegram, Slack, Messenger, Instagram, Teams, Discord, Google Chat, RCS). Tick the channels where each one makes sense. A PDF is useful on web chat or email, but on a phone call there's nowhere for the customer to open it. All channels and Off everywhere set a row in one click. Each capability you enable is described to the model on every step, so leave off anything the agent won't use.

To email a generated file, add an Email Sender with Attach a file the AI generated earlier ticked.

Legacy PDF Creator / CSV Creator / Report Creator nodes ​

Before the Built-in capabilities above existed, PDF/CSV/report generation was three separate action nodes. They're no longer in the node picker, but a workflow built before June 2026 that still has one keeps working — each behaves exactly like its matching Built-in capability.

PDF Creator ​

FieldWhat it doesOptionsDefaultShown when
Tool NameHow the AI refers to this tool. Blank → derived from the node label.
InstructionTell the AI WHEN to call this tool, WHAT inputs/payload to pass, and WHAT it returns — so it can decide whether and how to use the action. Blank → a generic default for the action.

CSV Creator ​

FieldWhat it doesOptionsDefaultShown when
Tool NameHow the AI refers to this tool. Blank → derived from the node label.
InstructionTell the AI WHEN to call this tool, WHAT inputs/payload to pass, and WHAT it returns — so it can decide whether and how to use the action. Blank → a generic default for the action.

Report Creator ​

FieldWhat it doesOptionsDefaultShown when
Tool NameHow the AI refers to this tool. Blank → derived from the node label.
InstructionTell the AI WHEN to call this tool, WHAT inputs/payload to pass, and WHAT it returns — so it can decide whether and how to use the action. Blank → a generic default for the action.

Beyond the agent ​

Need the same extraction outside a conversation? Use it as a flow step with the Document Processing node, or call the server-to-server endpoint POST /api/v1/documents.extract_structured from your own backend with a Perfox API key.

Next steps ​

You can now let your agent read and reason over any document a customer shares, in the mode that fits your use case.

  • Document Processing node — use this when extraction should happen as a fixed step in a flow, not triggered by the agent mid-conversation.
  • Document-type catalog — see the full list of built-in document types and the typed fields each one returns, useful when you choose Documented mode.
  • AI Agent node: how the agent decides which action to call, and the full Built-in capabilities section.
  • Messaging actions: send what the agent produced.