# FileSearchTool

> **Class** in `langchain_azure_ai`

📖 [View in docs](https://reference.langchain.com/python/langchain-azure-ai/tools/builtin/_tools/FileSearchTool)

A tool that searches for relevant content from uploaded vector stores.

Wraps :class:`openai.types.responses.FileSearchToolParam`.

Example::

    from langchain_azure_ai.tools.builtin import FileSearchTool

    tool = FileSearchTool(vector_store_ids=["vs_abc123"])
    model_with_search = model.bind_tools([tool])

## Signature

```python
FileSearchTool(
    self,
    vector_store_ids: List[str],
    *,
    max_num_results: Optional[int] = None,
    filters: Optional[FileSearchFilters] = None,
    ranking_options: Optional[RankingOptions] = None,
)
```

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `vector_store_ids` | `List[str]` | Yes | IDs of the vector stores to search.  At least one ID must be provided. |
| `max_num_results` | `Optional[int]` | No | Maximum number of results to return (1–50). (default: `None`) |
| `filters` | `Optional[FileSearchFilters]` | No | Optional metadata filter to narrow results.  Use :data:`~openai.types.responses.file_search_tool_param.Filters` (a :class:`~openai.types.shared_params.ComparisonFilter` or :class:`~openai.types.shared_params.CompoundFilter`). (default: `None`) |
| `ranking_options` | `Optional[RankingOptions]` | No | Ranking options.  Use :class:`~openai.types.responses.file_search_tool_param.RankingOptions` or a plain :class:`dict` with optional keys ``ranker`` and ``score_threshold``. (default: `None`) |

## Extends

- `BuiltinTool`

## Constructors

```python
__init__(
    self,
    vector_store_ids: List[str],
    *,
    max_num_results: Optional[int] = None,
    filters: Optional[FileSearchFilters] = None,
    ranking_options: Optional[RankingOptions] = None,
) -> None
```

| Name | Type |
|------|------|
| `vector_store_ids` | `List[str]` |
| `max_num_results` | `Optional[int]` |
| `filters` | `Optional[FileSearchFilters]` |
| `ranking_options` | `Optional[RankingOptions]` |


---

[View source on GitHub](https://github.com/langchain-ai/langchain-azure/blob/7a6a664d617264df8dcb12fcfb1bacc09f21d504/libs/azure-ai/langchain_azure_ai/tools/builtin/_tools.py#L207)