> ## 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.

# aresearch • AI Agent SDK

> aresearch: Async version of research().

# aresearch

<div className="flex items-center gap-2">
  <Badge color="blue">Async</Badge>
  <Badge color="purple">Method</Badge>
</div>

> This is a method of the [**DeepResearchAgent**](../classes/DeepResearchAgent) class in the [**deep\_research\_agent**](../modules/deep_research_agent) module.

Async version of research().

For Gemini, this still uses polling but with async sleep.
For OpenAI, uses the async client.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
async def aresearch(query: str, instructions: Optional[str], model: Optional[str], summary_mode: Optional[Literal['auto', 'detailed', 'concise']], web_search: Optional[bool], code_interpreter: Optional[bool], mcp_servers: Optional[List[Dict[str, Any]]], file_ids: Optional[List[str]], file_search: Optional[bool], file_search_stores: Optional[List[str]]) -> DeepResearchResponse
```

## Parameters

<ParamField query="query" type="str" required={true}>
  No description available.
</ParamField>

<ParamField query="instructions" type="Optional" required={false}>
  No description available.
</ParamField>

<ParamField query="model" type="Optional" required={false}>
  No description available.
</ParamField>

<ParamField query="summary_mode" type="Optional" required={false}>
  No description available.
</ParamField>

<ParamField query="web_search" type="Optional" required={false}>
  No description available.
</ParamField>

<ParamField query="code_interpreter" type="Optional" required={false}>
  No description available.
</ParamField>

<ParamField query="mcp_servers" type="Optional" required={false}>
  No description available.
</ParamField>

<ParamField query="file_ids" type="Optional" required={false}>
  No description available.
</ParamField>

<ParamField query="file_search" type="Optional" required={false}>
  No description available.
</ParamField>

<ParamField query="file_search_stores" type="Optional" required={false}>
  No description available.
</ParamField>

### Returns

<ResponseField name="Returns" type="DeepResearchResponse">
  The result of the operation.
</ResponseField>

## Uses

* `time.time`
* `debug`
* `asyncio.get_event_loop`
* `loop.run_in_executor`
* `ImportError`
* `litellm.aresponses`
* `create`
* `error`

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py#L1160">
  `praisonaiagents/agent/deep_research_agent.py` at line 1160
</Card>