Overview
Tool configuration allows you to set default parameters and overrides for tools like Tavily Search, Extract, Crawl, and Map. When an AI model calls a tool, your configured values are automatically applied, ensuring consistent behavior across your workflow.
Supported Tools
Tool configuration is currently available for Tavily tools: Search, Extract, Crawl, and Map. More tools will be added in future updates.How It Works
When you configure a tool, your settings are saved and applied automatically during workflow execution. The configuration process is straightforward:
Click on Tool Badge
In your workflow step, click on any configurable tool badge to open the configuration modal.
Set Your Parameters
Configure options like search depth, max results, domain restrictions, and more based on your needs.
Save Configuration
Click save and your configuration is applied. The tool badge shows a settings icon to indicate it has custom configuration.
Automatic Override
When the AI calls the tool during execution, your configured values override any parameters the model might specify.
Visual Indicator
Tool badges with custom configuration display a small settings icon, making it easy to identify which tools have been configured.Configuring Tools
Access tool configuration from two places in the workflow editor:
- Tool Badge Click: Click directly on a tool badge in the step node to open configuration.
- Config Panel: Open the Tools section in the step configuration panel and click any tool.
- Reset to Defaults: Use the Reset button in the modal to restore default settings.
- Per-Step Config: Each step can have different configurations for the same tool.
Tavily Search Options
Configure how the Tavily Search tool behaves when called by your AI model.
| Parameter | Description |
|---|---|
search_depth | Basic (faster, cheaper) or Advanced (more comprehensive results) |
max_results | Number of results to return (1-20, default: 5) |
topic | Search category: General, News, or Finance |
time_range | Filter by time: Day, Week, Month, Year, or Any time |
include_answer | Include AI-generated answer summary based on results |
include_images | Include relevant images in search results |
include_domains | Only search within these specific domains |
exclude_domains | Exclude these domains from search results |
Tavily Extract Options
Configure content extraction settings for the Tavily Extract tool.
| Parameter | Description |
|---|---|
extract_depth | Basic (main content) or Advanced (includes more details) |
include_images | Include images from the extracted content |
Best Practices
Follow these guidelines for effective tool configuration:
- Use domain restrictions for research that requires trusted sources
- Set appropriate max_results to balance comprehensiveness with cost
- Enable include_answer for quick summaries in research workflows
- Use time_range filters for news and current events research
- Configure different settings per step when tasks have different requirements
- Reset to defaults when troubleshooting unexpected behavior
Common Use Cases
| Use Case | Recommended Configuration |
|---|---|
| Documentation Research | Restrict search to official docs with include_domains, use advanced depth |
| News Monitoring | Set topic to news, time_range to day, enable include_answer |
| Competitor Analysis | Use crawl with specific domains, higher max_depth for comprehensive data |
Key Takeaways
- Click tool badges to access configuration options
- Configured tools show a settings icon indicator
- Domain restrictions help focus searches on trusted sources
- Each step can have different tool configurations
- Configurations are saved in your workflow and persist across sessions