Skip to content

Conversation

@guy-hartstein
Copy link
Contributor

Background

Tavily provides a suite of web-access tools trusted by over 800K developers worldwide. We're excited to announce our new Vercel AI SDK integration package (https://www.npmjs.com/package/@tavily/ai-sdk) which will allow developers to build Tavily-powered agents on Vercel AI SDK v5.

Summary

This PR adds Tavily tools to the new Vercel agent registry and tool-calling documentation.

Checklist

  • Tests have been added / updated (for bug fixes / features)
  • Documentation has been added / updated (for bug fixes / features)
  • A patch changeset for relevant packages has been added (for bug fixes / features - run pnpm changeset in the project root)
  • I have reviewed this pull request (self-review)

- Introduced Tavily as a new tool for real-time web search, extraction, crawling, and mapping.
- Updated documentation to include installation instructions and usage examples for Tavily.
- Added Tavily to the tools registry with relevant details and code examples.
guy-hartstein and others added 2 commits November 24, 2025 18:28
Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
guy-hartstein and others added 3 commits November 24, 2025 18:33
Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
@nicoalbanese nicoalbanese enabled auto-merge (squash) December 2, 2025 12:14
model: gateway('google/gemini-3-pro-preview'),
prompt: 'What are the latest developments in agentic search?',
tools: {
webSearch: tavilySearch,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
webSearch: tavilySearch,
webSearch: tavilySearch(),

The Tavily code example in the registry doesn't call the tool functions with parentheses, but the cookbook documentation shows they should be called with parentheses like tavilySearch() and tavilyExtract().

View Details

Analysis

Tavily code example in registry.ts missing function call parentheses

What fails: The Tavily tool code example in content/tools-registry/registry.ts (line 139) passes tavilySearch as a reference without calling it with parentheses, but the official Tavily documentation requires calling it as tavilySearch() to return the tool object. This causes the example to be incompatible with the Vercel AI SDK tools interface.

How to reproduce:

  1. View the Tavily example in content/tools-registry/registry.ts lines 131-143
  2. Compare it with the cookbook example in content/cookbook/05-node/56-web-search-agent.mdx lines 218-219
  3. Check that the cookbook correctly shows tavilySearch() and tavilyExtract() with parentheses

Result: Registry example shows webSearch: tavilySearch, without parentheses, while the cookbook and official documentation show webSearch: tavilySearch() with parentheses.

Expected: The registry example should call the function with parentheses, matching the pattern used by other similar tools in the same file (executeCode() on line 43, webSearch() on line 75) and matching the documented usage in the Tavily AI SDK documentation which states: "You pass the result of calling these functions to the tools object"

@nicoalbanese nicoalbanese merged commit ca38954 into vercel:main Dec 2, 2025
17 of 18 checks passed
vercel-ai-sdk bot pushed a commit that referenced this pull request Dec 2, 2025
<!--
Welcome to contributing to AI SDK! We're excited to see your changes.

We suggest you read the following contributing guide we've created
before submitting:

https://github.com/vercel/ai/blob/main/CONTRIBUTING.md
-->

## Background

Tavily provides a suite of web-access tools trusted by over 800K
developers worldwide. We're excited to announce our new Vercel AI SDK
integration package (https://www.npmjs.com/package/@tavily/ai-sdk) which
will allow developers to build Tavily-powered agents on Vercel AI SDK
v5.

<!-- Why was this change necessary? -->

## Summary

This PR adds Tavily tools to the new Vercel agent registry and
tool-calling documentation.

<!-- What did you change? -->

## Checklist

<!--
Do not edit this list. Leave items unchecked that don't apply. If you
need to track subtasks, create a new "## Tasks" section

Please check if the PR fulfills the following requirements:
-->

- [ ] Tests have been added / updated (for bug fixes / features)
- [x] Documentation has been added / updated (for bug fixes / features)
- [ ] A _patch_ changeset for relevant packages has been added (for bug
fixes / features - run `pnpm changeset` in the project root)
- [ ] I have reviewed this pull request (self-review)

---------

Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
Co-authored-by: nicoalbanese <[email protected]>
@vercel-ai-sdk vercel-ai-sdk bot removed the backport label Dec 2, 2025
@vercel-ai-sdk
Copy link
Contributor

vercel-ai-sdk bot commented Dec 2, 2025

✅ Backport PR created: #10805

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants