Research Agent Seltz

Generate a referenced research report with Seltz search and a Groq agent.

For free and developer tiers, Groq will shut down llama-3.3-70b-versatile on August 16, 2026. Replace it with openai/gpt-oss-120b before that date. See Groq deprecations.

research_agent_seltz.py

"""Run `pip install groq seltz agno` to install dependencies."""

from pathlib import Path
from textwrap import dedent

from agno.agent import Agent
from agno.models.groq import Groq
from agno.tools.seltz import SeltzTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

cwd = Path(__file__).parent.resolve()
tmp = cwd.joinpath("tmp")
if not tmp.exists():
    tmp.mkdir(exist_ok=True, parents=True)

agent = Agent(
    model=Groq(id="llama-3.3-70b-versatile"),
    tools=[SeltzTools(max_results=10, show_results=True)],
    description="You are an advanced AI researcher writing a report on a topic.",
    instructions=[
        "For the provided topic, run 3 different searches.",
        "Read the results carefully and prepare a report.",
        "Focus on facts and make sure to provide references.",
    ],
    expected_output=dedent(
        """\
        An engaging, informative, and well-structured report in markdown format:

        ## Engaging Report Title

        ### Overview
        {give a brief introduction of the report and why the user should read this report}
        {make this section engaging and create a hook for the reader}

        ### Section 1
        {break the report into sections}
        {provide details/facts/processes in this section}

        ... more sections as necessary...

        ### Takeaways
        {provide key takeaways from the article}

        ### References
        - [Reference 1](link)
        - [Reference 2](link)
        - [Reference 3](link)

        ### About the Author
        {write a made up for yourself, give yourself a cyberpunk name and a title}

        - published on {date} in dd/mm/yyyy
        """
    ),
    markdown=True,
    add_datetime_to_context=True,
    save_response_to_file=str(tmp.joinpath("{message}.md")),
)
agent.print_response("Recent advances in AI safety", stream=True)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    pass

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno groq seltz
   
3. Export your API keys

   Mac/Linux

   export GROQ_API_KEY="your_groq_api_key_here"
   export SELTZ_API_KEY="your_seltz_api_key_here"
   

   $Env:GROQ_API_KEY="your_groq_api_key_here"
   $Env:SELTZ_API_KEY="your_seltz_api_key_here"
   
4. Replace Llama 3.3

   Replace llama-3.3-70b-versatile with openai/gpt-oss-120b in the saved file.

5. Run the example

   Save the code above as research_agent_seltz.py, then run:

   python research_agent_seltz.py
   

Full source: cookbook/90_models/groq/research_agent_seltz.py