Seltz - Agno

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

Prerequisites

The following example requires the seltz library and an API key from Seltz.

uv pip install -U seltz openai

export SELTZ_API_KEY=***

Example

The following agent will search Seltz for AI safety reports.

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.seltz import SeltzTools

agent = Agent(
    model=OpenAIResponses(id="gpt-5.2"),
    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. In Agno v3.0 the old `max_documents` alias was removed; passing it raises a `TypeError`.
`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`. The filters require `seltz>=1.2.0`; older SDKs still work for plain searches through a fallback.

Developer Resources

Tools