> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Base Tool • AI Agent SDK
> BaseTool: Abstract base class for all PraisonAI tools.
# BaseTool
> Defined in the [**base**](../modules/base) module.
AI Agent
Abstract base class for all PraisonAI tools.
Subclass this to create custom tools that can be:
* Used directly by agents
* Distributed as pip-installable plugins
* Auto-discovered via entry\_points
Attributes:
name: Unique identifier for the tool
description: Human-readable description (used by LLM)
version: Tool version string (default: "1.0.0")
parameters: JSON Schema for parameters (auto-generated if not provided)
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#8B0000', 'primaryTextColor': '#fff', 'primaryBorderColor': '#710101', 'lineColor': '#189AB4', 'secondaryColor': '#189AB4', 'tertiaryColor': '#fff' }}}%%
graph LR
agent["Agent"] -- "uses" --> tool["Tool: BaseTool"]
tool -- "returns" --> result["Result"]
style tool fill:#189AB4,color:#fff
style agent fill:#8B0000,color:#fff
style result fill:#8B0000,color:#fff
```
## Constructor
No description available.
## Properties
No description available.
No description available.
No description available.
No description available.
## Methods
Validate a tool class before instantiation.
Execute the tool with given arguments.
Optional hook returning a compact, model-facing view of `result`.
Execute tool with error handling, returning ToolResult.
Get OpenAI-compatible function schema for this tool.
Validate the tool configuration.
Validate that schema can round-trip through OpenAI-style serialization.
## Usage
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
class WeatherTool(BaseTool):
name = "get_weather"
description = "Get current weather for a location"
def run(self, location: str, units: str = "celsius") -> dict:
# Implementation here
return {"temp": 22, "condition": "sunny"}
```
## Source
`praisonaiagents/tools/base.py` at line 179
***
## Related Documentation