Deep Research Agent • AI Agent SDK
DeepResearchAgent: Agent for performing deep research using multiple provider APIs.
DeepResearchAgent
Defined in the Deep Research Agent module.
AI Agent
Agent for performing deep research using multiple provider APIs.
Supports:
- OpenAI Deep Research: o3-deep-research, o4-mini-deep-research
- Gemini Deep Research: deep-research-pro-preview
- LiteLLM: Unified interface for OpenAI models
The provider is auto-detected based on the model name, or can be explicitly set.
Constructor
Optional[str]No description available.
Optional[str]No description available.
strNo description available.
OptionalNo description available.
Optional[str]No description available.
Optional[str]No description available.
boolNo description available.
LiteralNo description available.
boolNo description available.
boolNo description available.
boolNo description available.
OptionalNo description available.
OptionalNo description available.
boolNo description available.
intNo description available.
intNo description available.
Methods
Get the synchronous OpenAI client (lazy initialization).
async_openai_client()Get the asynchronous OpenAI client (lazy initialization).
gemini_client()Get the Gemini client (lazy initialization).
research()Perform a deep research query.
aresearch()Async version of research().
follow_up()Ask a follow-up question based on a previous research interaction.
clarify()Generate clarifying questions for a research query.
rewrite_query()Rewrite a research query to be more specific and detailed.
Usage
# OpenAI (default)
agent = DeepResearchAgent(
model="o3-deep-research",
instructions="You are a professional researcher."
)
# Gemini
agent = DeepResearchAgent(
model="deep-research-pro",
instructions="You are a professional researcher."
)
# Using LiteLLM
agent = DeepResearchAgent(
model="o3-deep-research",
use_litellm=True
)
result = agent.research("Research the economic impact of AI on healthcare.")
print(result.report)Source
View on GitHubpraisonaiagents/agent/deep_research_agent.py at line 151