> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-update-deprecated-models.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Seltz

**SeltzTools** enable an Agent to perform AI-powered semantic search using the Seltz API.

## Prerequisites

The following example require the `seltz` library and an API key from [Seltz](https://seltz.ai).

```shell theme={null}
uv pip install -U seltz
```

```shell theme={null}
export SELTZ_API_KEY=***
```

## Example

The following agent will search Seltz for AI safety reports.

```python theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.seltz import SeltzTools

agent = Agent(
    model=OpenAIChat(id="gpt-4o"),
    tools=[SeltzTools(show_results=True)],
    markdown=True,
)

agent.print_response("Search for current AI safety reports")
```

## Toolkit Params

| Parameter       | Type            | Default | Description                                                                |
| --------------- | --------------- | ------- | -------------------------------------------------------------------------- |
| `api_key`       | `Optional[str]` | `None`  | Seltz API key. If not provided, uses `SELTZ_API_KEY` environment variable. |
| `endpoint`      | `Optional[str]` | `None`  | Custom Seltz gRPC endpoint. If not provided, uses SDK default.             |
| `insecure`      | `bool`          | `False` | Use an insecure gRPC channel.                                              |
| `max_documents` | `int`           | `10`    | Default maximum number of documents to return per search.                  |
| `show_results`  | `bool`          | `False` | Log search results for debugging.                                          |
| `enable_search` | `bool`          | `True`  | Enable search tool functionality.                                          |
| `all`           | `bool`          | `False` | Enable all tools. Overrides individual flags when True.                    |

## Toolkit Functions

| Function       | Description                                                                                                                                            |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `search_seltz` | Search Seltz for a query. Returns results as JSON with document URLs and content. Accepts `query` (str) and optional `max_documents` (int) parameters. |

## Developer Resources

* View [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/seltz.py)