/extract which pulls explicitly stated values, /analyze uses a multi-step reasoning agent that can compute, infer, and derive answers that aren’t written in the document.
When to use Analyze vs Extract
Rule of thumb: if the answer is directly stated in the document, use
/extract. If it requires computation, comparison, or judgment, use /analyze.
Example
Response
Confidence scores
How the agent works
The analyze endpoint runs a multi-step reasoning agent that has access to:
The agent plans its approach, navigates to relevant sections, gathers evidence, cross-references, and verifies its answer before responding. Set
include_steps=true to see the full reasoning trace.