Agno integration - Valyu search tools

Use ValyuTools to add external search to an Agno agent. The toolkit exposes web search, academic search and search within an arXiv paper. Your agent chooses when to call them and uses the returned content and source URLs in its response.

Install and authenticate

pip install -U agno valyu openai
export VALYU_API_KEY="your-valyu-api-key"
export OPENAI_API_KEY="your-openai-api-key"

Get a Valyu key from the platform. The example uses Agno’s default model provider; configure another model through Agno if your application uses one.

Run a search agent

from agno.agent import Agent
from agno.tools.valyu import ValyuTools

agent = Agent(
    tools=[ValyuTools(max_results=5)],
    instructions=[
        "Search for evidence before answering research questions.",
        "Cite the source URLs and distinguish findings from interpretation.",
    ],
    markdown=True,
)

agent.print_response("Find recent papers on battery recycling and summarize the main approaches.")

Available tools

Tool	Purpose
`search_web`	Search web content with optional date and topic filters
`search_academic_sources`	Search the toolkit’s academic-source selection
`search_within_paper`	Retrieve relevant sections from a specified arXiv paper

Source access depends on your account and the endpoint. These are the tools documented by Agno; the toolkit is not a wrapper for every Valyu API. Use the Python SDK for direct access to other endpoints or custom source routing.

Configure returned context

tools = ValyuTools(
    max_results=5,
    text_length=2000,
    relevance_threshold=0.5,
    enable_web_search=True,
    enable_academic_search=True,
    enable_paper_search=True,
)

text_length limits the content returned to the agent per result. Adjust it alongside result count to balance the evidence your model sees against context size. A higher relevance threshold can remove useful results as well as noise, so test it on representative queries. For the complete configuration and installed-version behavior, see Agno’s Valyu toolkit reference.

Start here

APIs

Finance workflows

Sciences workflows

Build and connect

Comparisons

Agno

Install and authenticate

Run a search agent

Available tools

Configure returned context

Next steps

Write focused queries

Run a research task

​Install and authenticate

​Run a search agent

​Available tools

​Configure returned context

​Next steps

Write focused queries

Run a research task

Install and authenticate

Run a search agent

Available tools

Configure returned context

Next steps