Valyu

ValyuTools provides academic and web search capabilities with advanced filtering and relevance scoring.

Example

The following agent can perform academic and web searches:

1from kern.agent import Agent
2from kern.tools.valyu import ValyuTools
3
4agent = Agent(
5 instructions=[
6 "You are a research assistant that helps find academic papers and web content",
7 "Use Valyu to search for high-quality, relevant information",
8 "Provide detailed analysis of search results with relevance scores",
9 "Focus on credible sources and academic publications",
10 ],
11 tools=[ValyuTools()],
12)
13
14agent.print_response("Find recent research papers about machine learning in healthcare", stream=True)

Toolkit Params

ParameterTypeDefaultDescription
api_keyOptional[str]NoneValyu API key. Uses VALYU_API_KEY if not set.
enable_academic_searchboolTrueEnable academic sources search functionality.
enable_web_searchboolTrueEnable web search functionality.
enable_paper_searchboolTrueEnable search within paper functionality.
text_lengthint1000Maximum length of text content per result.
max_resultsint10Maximum number of results to return.
relevance_thresholdfloat0.5Minimum relevance score for results.
content_categoryOptional[str]NoneContent category for filtering.
search_start_dateOptional[str]NoneStart date for search filtering (YYYY-MM-DD).
search_end_dateOptional[str]NoneEnd date for search filtering (YYYY-MM-DD).
search_domainsOptional[List[str]]NoneList of domains to search within.
sourcesOptional[List[str]]NoneList of specific sources to search.
max_pricefloat30.0Maximum price for API calls.

Toolkit Functions

FunctionDescription
academic_searchSearch academic sources for research papers and publications.
web_searchSearch web sources for general information and content.
paper_searchSearch within specific papers for detailed information.

Developer Resources