> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Research Agent • AI Agent SDK

> Deep Research Agent Module

# deep\_research\_agent

<Badge color="blue">AI Agent</Badge>

Deep Research Agent Module

This module provides the DeepResearchAgent class for automating complex research
workflows using Deep Research APIs from multiple providers:

* **OpenAI**: o3-deep-research, o4-mini-deep-research (via Responses API)
* **Gemini**: deep-research-pro (via Interactions API)

The agent automatically detects the provider based on the model name and uses
the appropriate API.

Example:
from praisonaiagents import DeepResearchAgent

# OpenAI Deep Research

agent = DeepResearchAgent(
name="Research Assistant",
model="o3-deep-research",
instructions="You are a professional researcher..."
)

# Gemini Deep Research

agent = DeepResearchAgent(
name="Research Assistant",
model="deep-research-pro",
instructions="You are a professional researcher..."
)

result = agent.research("What are the economic impacts of AI on healthcare?")
print(result.report)
for citation in result.citations:
print(f"- \{citation.title}: \{citation.url}")

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents.agent import deep_research_agent
```

## Classes

<CardGroup cols={2}>
  <Card title="Citation" icon="brackets-curly" href="../classes/Citation">
    Represents a citation in the research report.
  </Card>

  <Card title="ReasoningStep" icon="brackets-curly" href="../classes/ReasoningStep">
    Represents a reasoning step in the research process.
  </Card>

  <Card title="WebSearchCall" icon="brackets-curly" href="../classes/WebSearchCall">
    Represents a web search call made during research.
  </Card>

  <Card title="CodeExecutionStep" icon="brackets-curly" href="../classes/CodeExecutionStep">
    Represents a code execution step during research.
  </Card>

  <Card title="MCPCall" icon="brackets-curly" href="../classes/MCPCall">
    Represents an MCP tool call during research.
  </Card>

  <Card title="FileSearchCall" icon="brackets-curly" href="../classes/FileSearchCall">
    Represents a file search call (Gemini-specific).
  </Card>

  <Card title="DeepResearchResponse" icon="brackets-curly" href="../classes/DeepResearchResponse">
    Complete response from a Deep Research query.
  </Card>

  <Card title="Provider" icon="brackets-curly" href="../classes/Provider">
    Supported Deep Research providers.
  </Card>

  <Card title="DeepResearchAgent" icon="brackets-curly" href="../classes/DeepResearchAgent">
    Agent for performing deep research using multiple provider APIs.
  </Card>
</CardGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Agents Concept" icon="robot" href="/docs/concepts/agents" />

  <Card title="Single Agent Guide" icon="book-open" href="/docs/guides/single-agent" />

  <Card title="Multi-Agent Guide" icon="users" href="/docs/guides/multi-agent" />

  <Card title="Agent Configuration" icon="gear" href="/docs/configuration/agent-config" />

  <Card title="Auto Agents" icon="wand-magic-sparkles" href="/docs/features/autoagents" />
</CardGroup>
