Seltz

Run AI-powered semantic search against the Seltz gRPC API with SeltzTools.

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.
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

• Tools