Skip to content

Conversation

@guy-hartstein
Copy link

@guy-hartstein guy-hartstein commented Dec 16, 2025

This pull request enhances the TavilySearchTool by expanding its configuration options, improving documentation, and ensuring support for new parameters introduced by tavily-python. The changes make the tool more flexible and future-proof, allowing both users and agents to fine-tune search behavior at runtime or initialization, and to pass through new options as needed.

Key changes:

Feature Enhancements

  • Added new parameters to TavilySearchTool and its schema, including start_date, end_date, country, auto_parameters, include_favicon, include_usage, and support for extra_kwargs to pass arbitrary arguments to tavily-python. Also, include_raw_content now accepts "markdown" and "text" in addition to bool. [1] [2] [3]
  • Updated both synchronous (_run) and asynchronous (_arun) search methods to accept and forward the new parameters and extra_kwargs to the underlying tavily-python client. [1] [2] [3] [4] [5] [6]

Documentation Updates

  • Significantly revised English and Korean documentation to clearly distinguish between agent-settable (runtime) and user-settable (initialization) parameters. All new parameters are now documented, and examples have been updated to reflect these changes. [1] [2] [3]
  • Added documentation and usage examples for extra_kwargs in both the main README and tool documentation, explaining how to forward new tavily-python parameters not yet explicitly supported. [1] [2]

Minor Improvements

  • Clarified output documentation to refer to "raw content" instead of "raw HTML content" and linked to the Tavily API docs for response structure details in both English and Korean. [1] [2]

These updates make the tool easier to use, more adaptable to future API changes, and better documented for both English and Korean users.


Note

Adds new Tavily parameters (dates, country, auto-tuning, favicon/usage), runtime overrides for depth/time, extra_kwargs passthrough, and updates EN/KO docs accordingly.

  • Tool Enhancements (lib/crewai-tools/.../tavily_search_tool.py):
    • Extend TavilySearchToolSchema with runtime search_depth and time_range.
    • Add new config fields: start_date, end_date, country, auto_parameters, include_favicon, include_usage, and extra_kwargs.
    • Broaden include_raw_content to accept "markdown" | "text" in addition to bool.
    • Update _run and _arun to accept runtime search_depth/time_range, forward all new params, and pass through **extra_kwargs to tavily-python.
  • Documentation:
    • EN/KO guides (docs/en/.../tavilysearchtool.mdx, docs/ko/.../tavilysearchtool.mdx): clarify agent-settable vs. user-settable params; document new options; update examples; switch phrasing to "raw content" and add link to Tavily API response docs.
    • README (lib/crewai-tools/.../README.md): document extra_kwargs argument and provide usage example.

Written by Cursor Bugbot for commit 65becd1. This will update automatically on new commits. Configure here.

- Add search_depth and time_range as run-time parameters
- Add start_date, end_date, country filters
- Add auto_parameters, include_favicon, include_usage options
- Add extra_kwargs for forward compatibility with tavily-python
- Update include_raw_content to support 'markdown' and 'text' formats
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant