Skip to main content
Tavily is a search engine built specifically for AI agents (LLMs), delivering real-time, accurate, and factual results at speed. Tavily offers a Get Research endpoint that retrieves previously created research reports by request ID. Use this tool after TavilyResearch to poll for status and fetch completed results.

Overview

Integration details

Tool features

Setup

The integration lives in the @langchain/tavily package:

Credentials

Set up an API key on the Tavily dashboard and set it as an environment variable named TAVILY_API_KEY.
It is also helpful (but not needed) to set up LangSmith for observability:

Instantiation

You can import and instantiate TavilyGetResearch like this:

Invocation

Invoke directly with args

The Tavily get research tool accepts the following argument during invocation:
  • requestId (required): The unique identifier of the research task to retrieve

Invoke with ToolCall

You can also invoke the tool with a model-generated ToolCall, in which case a ToolMessage is returned:

Use within an agent

Pass both research tools to createAgent so the agent can start a research task and retrieve results by request ID:

API reference

For detailed documentation of all Tavily Get Research API features and configurations, see the API reference: docs.tavily.com/documentation/api-reference/endpoint/research-get