Performs autonomous deep research using the configured provider with web search and analysis capabilities.

What it does:

• Decomposes complex queries into research strategies

• Conducts real-time web searches for current information

• Executes code for data analysis and visualization (when include_analysis=True)

• Synthesizes findings into comprehensive reports with citations

Best for:

• Current events and recent developments

• Data-driven analysis requiring statistics/charts

• Complex topics needing multiple source synthesis

• Academic-style research with proper citations

Returns: Structured markdown report with citations, metadata, and research insights.

Note: Uses provider-native research backends - monitor costs as research can generate substantial tokens.

Check the current status and progress of a running research task.

Use when:

• Research is taking a long time (>5 minutes)

• Want to check if a task completed successfully

• Need creation/completion timestamps

Returns: Task status ('running', 'completed', 'failed') with timestamps.

Perform research using an enriched query based on clarification answers.

Use after:

• Calling deep_research with request_clarification=True

• Receiving clarifying questions and a session ID

• Gathering answers from the user

What it does:

• Takes your answers to clarifying questions

• Creates an enriched, more specific research query

• Performs comprehensive research with the enhanced query

Returns: Complete research report with citations and metadata