Deep Research

Deep Research gives agents the ability to autonomously search the web, read sources, extract knowledge, and synthesize findings across multiple research waves.

Enable Deep Research

from definable.agent import Agent

agent = Agent(model="gpt-4o", deep_research=True)

output = await agent.arun("What are the latest advances in quantum computing?")
print(output.content)  # Grounded response with citations

Custom Configuration

from definable.agent.research import DeepResearchConfig

agent = Agent(
    model="gpt-4o",
    deep_research=DeepResearchConfig(
        depth="deep",                  # "quick", "standard", or "deep"
        search_provider="duckduckgo",  # or "google", "serpapi"
        max_sources=30,
        max_waves=5,
        include_citations=True,
    ),
)

Depth Presets

Preset	Waves	Sources	Use case
`quick`	1	8	Fast fact-checking
`standard`	3	15	Balanced research (default)
`deep`	5	30	Comprehensive analysis

How It Works

Wave 1: Generate search queries from the user’s question.
Search: Execute queries via the configured search provider.
Read: Fetch and parse source pages concurrently.
Extract: Use a compression model to extract Compact Knowledge Units (CKUs).
Evaluate: Score relevance, detect contradictions, identify gaps.
Repeat: Generate follow-up queries and research further (waves 2+).
Inject: Final CKUs are injected into the agent’s system prompt.

Configuration Reference

str

default:"standard"

Research depth: "quick", "standard", or "deep".

str

default:"duckduckgo"

Search backend: "duckduckgo", "google", or "serpapi".

int

default:"15"

Maximum unique sources across all waves.

int

default:"3"

Maximum research waves.

bool

default:"true"

Include source citations in the research context.

str

default:"always"

When to research: "always", "auto" (model decides), "tool" (explicit call).

Imports

from definable.agent.research import DeepResearchConfig

Get Started

Basics

Capabilities

Advanced

Enable Deep Research

Custom Configuration

Depth Presets

How It Works

Configuration Reference

Imports

​Enable Deep Research

​Custom Configuration

​Depth Presets

​How It Works

​Configuration Reference

​Imports

Enable Deep Research

Custom Configuration

Depth Presets

How It Works

Configuration Reference

Imports