Overview
CrewAI tools empower agents with capabilities ranging from web searching and data analysis to collaboration and delegating tasks among coworkers. This documentation outlines how to create, integrate, and leverage these tools within the CrewAI framework, including a new focus on collaboration tools.Tools give agents callable functions to take action. They work alongside MCPs (remote tool servers), Apps (platform integrations), Skills (domain expertise), and Knowledge (retrieved facts). See the Agent Capabilities overview to understand when to use each.
What is a Tool?
A tool in CrewAI is a skill or function that agents can utilize to perform various actions. This includes tools from the CrewAI Toolkit and LangChain Tools, enabling everything from simple searches to complex interactions and effective teamwork among agents.CrewAI AMP provides a comprehensive Tools Repository with pre-built integrations for common business systems and APIs. Deploy agents with enterprise tools in minutes instead of days.The Enterprise Tools Repository includes:
- Pre-built connectors for popular enterprise systems
- Custom tool creation interface
- Version control and sharing capabilities
- Security and compliance features
Key Characteristics of Tools
- Utility: Crafted for tasks such as web searching, data analysis, content generation, and agent collaboration.
- Integration: Boosts agent capabilities by seamlessly integrating tools into their workflow.
- Customizability: Provides the flexibility to develop custom tools or utilize existing ones, catering to the specific needs of agents.
- Error Handling: Incorporates robust error handling mechanisms to ensure smooth operation.
- Caching Mechanism: Features intelligent caching to optimize performance and reduce redundant operations.
- Asynchronous Support: Handles both synchronous and asynchronous tools, enabling non-blocking operations.
- Typed Outputs: Uses optional Pydantic models to give agents clear JSON fields while direct Python calls still receive the tool’s normal return value.
Using CrewAI Tools
To enhance your agents’ capabilities with crewAI tools, begin by installing our extra tools package:Code
Available CrewAI Tools
- Error Handling: All tools are built with error handling capabilities, allowing agents to gracefully manage exceptions and continue their tasks.
- Caching Mechanism: All tools support caching, enabling agents to efficiently reuse previously obtained results, reducing the load on external resources and speeding up the execution time. You can also define finer control over the caching mechanism using the
cache_functionattribute on the tool.
Creating your own Tools
There are two main ways for one to create a CrewAI tool:Subclassing BaseTool
Code
Typed Tool Outputs
When a tool returns structured data, define a Pydantic output model. This gives the agent field names it can trust, such assku, quantity, or needs_reorder.
Direct Python calls still receive the value your tool returns. When an agent uses the tool, CrewAI sends the agent a JSON string based on the output model.
Code
format_output_for_agent. Direct calls to tool.run(...) still return the normal Python value.
Code
format_output_for_agent, typed outputs are sent to the agent as JSON. Plain string results work as before.
Asynchronous Tool Support
CrewAI supports asynchronous tools, allowing you to implement tools that perform non-blocking operations like network requests, file I/O, or other async operations without blocking the main execution thread.Creating Async Tools
You can create async tools in two ways:1. Using the tool Decorator with Async Functions
Code
2. Implementing Async Methods in Custom Tool Classes
Code
Using Async Tools
Async tools work seamlessly in both standard Crew workflows and Flow-based workflows:Code
Utilizing the tool Decorator
Code
Custom Caching Mechanism
Code
