The CalculatorTool provides basic arithmetic operations for agents, enabling precise numerical calculations.
Class Signature
class CalculatorTool(BaseTool):
name = "calculator"
description = "Perform basic arithmetic operations"
def __init__()
Methods
The calculator provides four basic arithmetic operations, all decorated with @capability to make them available to agents.
add
Add two numbers together.
@capability
def add(self, a: float, b: float) -> str
subtract
Subtract the second number from the first.
@capability
def subtract(self, a: float, b: float) -> str
The second number to subtract.
multiply
Multiply two numbers.
@capability
def multiply(self, a: float, b: float) -> str
divide
Divide the first number by the second.
@capability
def divide(self, a: float, b: float) -> str
The denominator (divisor).
Usage Example
from agentor.tools import CalculatorTool
# Initialize the calculator
calc = CalculatorTool()
# Perform calculations
print(calc.add(10, 5)) # "15.0"
print(calc.subtract(10, 5)) # "5.0"
print(calc.multiply(10, 5)) # "50.0"
print(calc.divide(10, 5)) # "2.0"
print(calc.divide(10, 0)) # "Error: Division by zero"
With Agentor Agent
from agentor import Agentor
from agentor.tools import CalculatorTool
agent = Agentor(
name="Math Assistant",
model="gpt-4",
tools=[CalculatorTool()],
instructions="Perform accurate calculations using the calculator tool.",
)
result = agent.run("What is 1234 multiplied by 5678?")
print(result.final_output)
Multi-Step Calculations
The agent can chain multiple operations together:
from agentor import Agentor
from agentor.tools import CalculatorTool
agent = Agentor(
name="Calculator Agent",
model="gpt-4",
tools=[CalculatorTool()],
instructions="Break down complex calculations into steps.",
)
result = agent.run(
"Calculate (15 + 25) * 3 / 2 and explain each step"
)
print(result.final_output)
from agentor import Agentor
from agentor.tools import CalculatorTool, WebSearchTool
agent = Agentor(
name="Research Calculator",
model="gpt-4",
tools=[CalculatorTool(), WebSearchTool()],
instructions="""
Search for current data when needed, then perform
accurate calculations using the calculator tool.
""",
)
result = agent.run(
"Find the current price of Bitcoin and calculate how much 2.5 BTC is worth"
)
print(result.final_output)
Error Handling
The tool handles division by zero gracefully:
calc = CalculatorTool()
result = calc.divide(10, 0)
print(result) # "Error: Division by zero"
Return Type
All methods return string representations of numbers to ensure compatibility with LLM agents and avoid floating-point precision issues in downstream processing.
Precision
The calculator uses Python’s float type, which provides:
- Approximately 15-17 decimal digits of precision
- Support for very large and very small numbers
- Standard floating-point arithmetic behavior
For applications requiring arbitrary precision, consider implementing a custom tool using Python’s decimal module.
Best Practices
- Use for Accuracy: Prefer calculator tool over LLM arithmetic for precise calculations
- Chain Operations: Break complex formulas into multiple steps
- Validate Results: Have the agent explain calculations when needed
- Combine Tools: Use with web search for real-time data calculations
Source: /home/daytona/workspace/source/src/agentor/tools/calculator.py:4