Exa

ExaTools enable an Agent to search the web using Exa, retrieve content from URLs, find similar content, and get AI-powered answers.

Prerequisites

The following examples require the exa-py library and an API key which can be obtained from Exa.

1uv pip install -U exa-py

1export EXA_API_KEY=***

Example

The following agent will search Exa for AAPL news and print the response.

1from kern.agent import Agent
2from kern.tools.exa import ExaTools
3
4agent = Agent(
5    tools=[ExaTools(
6        include_domains=["cnbc.com", "reuters.com", "bloomberg.com"],
7        category="news",
8        show_results=True,
9        text_length_limit=1000,
10    )],
11    )
12agent.print_response("Search for AAPL news", markdown=True)

Toolkit Functions

Function	Description
`search_exa`	Searches Exa for a query with optional category filtering
`get_contents`	Retrieves detailed content from specific URLs
`find_similar`	Finds similar content to a given URL
`exa_answer`	Gets an AI-powered answer to a question using Exa search results

Toolkit Params

Parameter	Type	Default	Description
`enable_search`	`bool`	`True`	Enable search functionality
`enable_get_contents`	`bool`	`True`	Enable content retrieval
`enable_find_similar`	`bool`	`True`	Enable finding similar content
`enable_answer`	`bool`	`True`	Enable AI-powered answers
`enable_research`	`bool`	`True`	Enable research functionality
`all`	`bool`	`False`	Enable all functionality
`text`	`bool`	`True`	Include text content in results
`text_length_limit`	`int`	`1000`	Maximum length of text content per result
`highlights`	`bool`	`True`	Include highlighted snippets
`summary`	`bool`	`False`	Include result summaries
`num_results`	`Optional[int]`	`None`	Default number of results
`livecrawl`	`str`	`"always"`	Livecrawl behavior
`start_crawl_date`	`Optional[str]`	`None`	Include results crawled after date (YYYY-MM-DD)
`end_crawl_date`	`Optional[str]`	`None`	Include results crawled before date (YYYY-MM-DD)
`start_published_date`	`Optional[str]`	`None`	Include results published after date (YYYY-MM-DD)
`end_published_date`	`Optional[str]`	`None`	Include results published before date (YYYY-MM-DD)
`use_autoprompt`	`Optional[bool]`	`None`	Enable autoprompt features
`type`	`Optional[str]`	`None`	Content type filter (e.g., article, blog, video)
`category`	`Optional[str]`	`None`	Category filter (e.g., news, research paper)
`include_domains`	`Optional[List[str]]`	`None`	Restrict results to these domains
`exclude_domains`	`Optional[List[str]]`	`None`	Exclude results from these domains
`show_results`	`bool`	`False`	Log search results for debugging
`model`	`Optional[str]`	`None`	Search model to use ('exa' or 'exa-pro')

Developer Resources

View Tools

Exa

Prerequisites

Example

Toolkit Functions

Toolkit Params

Categories

Developer Resources