Perform complex, long-running research tasks using Gemini Deep Research Agent. Use when asked to research topics requiring multi-source synthesis, competitive analysis, market research, or comprehensive technical investigations that benefit from systematic web search and analysis.
Use Gemini's Deep Research Agent to perform complex, long-running context gathering and synthesis tasks.
GEMINI_API_KEY environment variable (from Google AI Studio)Deep Research is an agent that:
scripts/deep_research.py --query "Research the history of Google TPUs"
scripts/deep_research.py --query "Research the competitive landscape of EV batteries" \
--format "1. Executive Summary\n2. Key Players (include data table)\n3. Supply Chain Risks"
scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \
--file-search-store "fileSearchStores/my-store-name"
scripts/deep_research.py --query "Your research topic" --stream
The script saves results to timestamped files:
deep-research-YYYY-MM-DD-HH-MM-SS.md - Final report in markdowndeep-research-YYYY-MM-DD-HH-MM-SS.json - Full interaction metadatahttps://generativelanguage.googleapis.com/v1beta/interactionsdeep-research-pro-preview-12-2025x-goog-api-key header (NOT OAuth Bearer token)