DeepResearchAgent Module
TheDeepResearchAgent class automates complex research workflows using Deep Research APIs from multiple providers.
Supported Providers
- OpenAI:
o3-deep-research,o4-mini-deep-research(via Responses API) - Gemini:
deep-research-pro(via Interactions API)
Import
Quick Example
Constructor
DeepResearchAgent()
Creates a new DeepResearchAgent instance.
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
name | str | "Deep Research Agent" | Agent name |
model | str | "o3-deep-research" | Deep research model to use |
instructions | str | "" | System instructions for research |
verbose | bool | False | Enable verbose logging |
Methods
research(query)
Performs deep research on a given query.
Parameters:
query(str): The research question or topic
ResearchResult - Contains report, citations, reasoning steps
async_research(query)
Async version of the research method.
Parameters:
query(str): The research question or topic
ResearchResult - Contains report, citations, reasoning steps
Data Classes
Citation
Represents a citation in the research report.
ReasoningStep
Represents a reasoning step in the research process.
WebSearchCall
Represents a web search call made during research.
ResearchResult
The complete result of a research operation.
Example with Gemini
Related
- Agent Module - Base Agent class
- QueryRewriterAgent Module - Query optimization for RAG
- Knowledge Module - Knowledge base integration

