> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/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(max_results=5, 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_results`   | `Optional[int]` | `None`  | Default maximum number of results to return per search. Defaults to `10` when unset. |
| `max_documents` | `Optional[int]` | `None`  | Deprecated alias for `max_results`.                                                  |
| `context`       | `Optional[str]` | `None`  | Legacy SDK context to improve search quality. Ignored by current Seltz SDK versions. |
| `profile`       | `Optional[str]` | `None`  | Legacy SDK search profile to use for ranking.                                        |
| `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), optional `max_results` (int), and optional filters: `scope`, `include_domains`, `exclude_domains`, `from_date`, and `to_date`. `max_documents` remains available as a deprecated alias for `max_results`. |

## Developer Resources

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