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

# Research Tool

The Research tool iteratively searches the web, analyzes the results, and stops when finished. It then provides a comprehensive report to your agent with current, cited information.

To enable it, pass it through the `tools` option:

```json theme={null}
{
  ...
  "tools": [
    ...
    {
      "type": "research",
      "search_effort": "auto | low | medium | high",
      "report_verbosity": "medium | high"
    }
  ]
}
```

<ParamField body="search_effort" type="string">
  This parameter maps to different configurations regarding the depth of research the subagent can perform. Its values range from `low`, `medium` to `high`. Alternatively, use`auto` mode for a more dynamic search approach, allowing the subagent the freedom to adjust its subparameters.
</ParamField>

<ParamField body="report_verbosity" type="string">
  Select whether to receive a `medium` or `high` length model response.
</ParamField>