Prerequisites
- Python 3.10 or higher
- PraisonAI Agents package installed
exa_pypackage installedEXA_API_KEYenvironment variable set
Installation
Setup
Built-in Exa Tool
PraisonAI provides a built-inexa tool that you can import directly:
Available Functions
| Function | Description |
|---|---|
exa | Neural search (alias for exa_search) |
exa_search | Basic web search |
exa_search_contents | Search with full text/highlights |
exa_find_similar | Find similar pages to a URL |
exa_answer | AI-generated answers with citations |
Basic Usage
Simple Search
Search with Options
Search with Content
Find Similar Pages
AI-Generated Answers
With PraisonAI Agent
Using ExaTools Class
For more control, use theExaTools class directly:
Search Parameters
| Parameter | Type | Description |
|---|---|---|
query | str | Search query |
num_results | int | Number of results (default 10, max 100) |
type | str | ”auto”, “neural”, “fast”, or “deep” |
category | str | Data category filter |
include_domains | list | Domains to include |
exclude_domains | list | Domains to exclude |
start_crawl_date | str | Only links crawled after this date |
end_crawl_date | str | Only links crawled before this date |
start_published_date | str | Only links published after this date |
end_published_date | str | Only links published before this date |
include_text | list | Strings that must be present |
exclude_text | list | Strings that must not be present |
Categories
Exa supports filtering by data categories:| Category | Description |
|---|---|
company | Company websites |
research paper | Academic papers |
news | News articles |
linkedin profile | LinkedIn profiles |
github | GitHub repositories |
tweet | Twitter/X posts |
movie | Movie information |
song | Music information |
personal site | Personal websites |
pdf | PDF documents |
financial report | Financial reports |
Deep Search
For comprehensive research, use deep search with additional queries:Structured Summaries
Get structured data from search results:Key Points
- Neural search: AI-powered semantic understanding of queries
- Environment variable: Set
EXA_API_KEYbefore running - Categories: Filter results by data type for cleaner results
- Deep search: Use additional queries for comprehensive research
- Structured output: Get JSON-formatted summaries with schemas

