Skip to content

exa_search_tool

langroid/agent/tools/exa_search_tool.py

A tool to trigger a Exa search for a given query, (https://docs.exa.ai/reference/getting-started) and return the top results with their titles, links, summaries. Since the tool is stateless (i.e. does not need access to agent state), it can be enabled for any agent, without having to define a special method inside the agent: agent.enable_message(ExaSearchTool)

NOTE: To use this tool, you need to:

  • set the EXA_API_KEY environment variables in your .env file, e.g. EXA_API_KEY=your_api_key_here (Note as of 28 Jan 2023, Metaphor renamed to Exa, so you can also use EXA_API_KEY=your_api_key_here)

  • install langroid with the exa-py extra, e.g. pip install langroid[exa] or uv pip install langroid[exa] or poetry add langroid[exa] or uv add langroid[exa] (it installs the exa_py package from pypi).

For more information, please refer to the official docs: https://exa.ai/

ExaSearchTool

Bases: ToolMessage

handle()

Conducts a search using the exa API based on the provided query and number of results by triggering a exa_search.

Returns:

Name Type Description
str str

A formatted string containing the titles, links, and summaries of each search result, separated by two newlines.
Source code in langroid/agent/tools/exa_search_tool.py 
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
def handle(self) -> str:
    """
    Conducts a search using the exa API based on the provided query
    and number of results by triggering a exa_search.

    Returns:
        str: A formatted string containing the titles, links, and
            summaries of each search result, separated by two newlines.
    """

    search_results = exa_search(self.query, self.num_results)
    # return Title, Link, Summary of each result, separated by two newlines
    results_str = "\n\n".join(str(result) for result in search_results)
    return f"""
    BELOW ARE THE RESULTS FROM THE WEB SEARCH. USE THESE TO COMPOSE YOUR RESPONSE:
    {results_str}
    """