feat: add Airweave tools to crewai-tools

[EwanTauran]

Add Airweave Search Tools

Summary

Adds two new tools for unified semantic search across 50+ connected data sources (Stripe, GitHub, Notion, Slack, etc.) via Airweave:

• AirweaveSearchTool - Basic semantic search
• AirweaveAdvancedSearchTool - Advanced search with source filtering, AI reranking, and score thresholds

Quick Start

from crewai import Agent, Task, Crew
from crewai_tools import AirweaveSearchTool, AirweaveAdvancedSearchTool

# Basic search across all sources
search_tool = AirweaveSearchTool(collection_id="my-collection-id")

# Advanced search with filtering
advanced_tool = AirweaveAdvancedSearchTool(collection_id="my-collection-id")

agent = Agent(
    role="Data Analyst",
    goal="Find information from connected data sources",
    tools=[search_tool, advanced_tool]
)

task = Task(
    description="Find failed payments from Stripe in the last week",
    agent=agent
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()

Key Features

• ✅ Unified search across 50+ data sources (Stripe, GitHub, Salesforce, Zendesk, Slack, Notion, etc.)
• ✅ Semantic search with natural language understanding
• ✅ Hybrid search (neural + keyword matching)
• ✅ AI-generated answers via response_type="completion"
• ✅ Source filtering and AI reranking (Advanced tool)
• ✅ Full async support
• ✅ Interactive package installation

Installation

pip install 'crewai-tools[airweave]'
export AIRWEAVE_API_KEY="your_api_key"  # Get from https://app.airweave.ai

Parameters

AirweaveSearchTool

Parameter	Default	Description
query	Required	Search query
limit	10	Max results (1-100)
response_type	"raw"	"raw" or "completion"
recency_bias	0.0	Recent result weight (0.0-1.0)

AirweaveAdvancedSearchTool (Additional)

Parameter	Default	Description
source_filter	None	Filter by source (e.g., "Stripe")
score_threshold	None	Min similarity score (0.0-1.0)
recency_bias	0.3	Recent result weight
enable_reranking	True	AI reranking for better relevance
search_method	"hybrid"	"hybrid", "neural", or "keyword"

Testing

• ✅ 18 tests, 100% passing
• ✅ Zero linting errors
• ✅ Full coverage of core functionality

pytest tests/tools/airweave_tool_test.py -v

Implementation Details

• Follows all CrewAI tool patterns (BaseTool, EnvVar, interactive installation)
• Module-level imports with availability flags (like Tavily, Linkup)
• Both sync and async clients initialized in __init__()
• Mirrors Airweave Python SDK methods (search() and search_advanced())
• Comprehensive README with examples and troubleshooting

Files Added

• lib/crewai-tools/src/crewai_tools/tools/airweave_tool/ (4 files, ~1,033 lines)
• lib/crewai-tools/tests/tools/airweave_tool_test.py (18 tests)
• Updated exports and dependencies

Migration Note

Originally developed as PR #483 in the archived crewAI-tools repo. Migrated to main CrewAI repo with enhancements:

• Interactive installation prompts
• Improved async error messages
• Enhanced test mocking patterns

Checklist

• Tests passing (18/18)
• Documentation included
• No linting errors
• Follows CrewAI patterns
• Backward compatible

---

Note

Introduce AirweaveSearchTool and AirweaveAdvancedSearchTool for unified search across connected data sources, with docs, tests, and an airweave optional dependency.

• Tools:
  • Add AirweaveSearchTool for basic search and AI completion via response_type.
  • Add AirweaveAdvancedSearchTool with source_filter, recency_bias, score_threshold, reranking, and selectable search methods.
• Packaging/Exports:
  • Add airweave extra and dependency airweave-sdk>=0.1.0 in lib/crewai-tools/pyproject.toml.
  • Export new tools in crewai_tools/__init__.py and create tools/airweave_tool/__init__.py.
• Docs & Tests:
  • Add tools/airweave_tool/README.md with setup, parameters, examples, and troubleshooting.
  • Add tests/tools/airweave_tool_test.py covering init, raw/completion modes, filtering, error handling, and async paths.

^{Written by Cursor Bugbot for commit a3e3e4f. This will update automatically on new commits. Configure here.}

Addresses #4014

[cursor]

This PR is being reviewed by Cursor Bugbot

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.