Skip to main content

​
Calculator Agent

A mathematical calculator agent with various calculation tools using the OpenAI API.

​
Features

The calculator agent provides 8 specialized mathematical tools:

​
Basic Arithmetic

  • add_numbers - Addition of two numbers
  • subtract_numbers - Subtraction
  • multiply_numbers - Multiplication
  • divide_numbers - Division (with zero-check)

​
Financial Calculations

  • calculate_compound_interest - Compound interest calculator with customizable compounding periods

​
Geometric Calculations

  • calculate_circle_area - Circle area from radius
  • calculate_triangle_area - Triangle area from base and height

​
Unit Conversions

  • convert_temperature - Temperature conversion between Celsius, Fahrenheit, and Kelvin

​
Setup

​
1. Install Dependencies

cd examples/calculator-agent
chmod +x setup.sh
./setup.sh
This installs:
  • openai-agents - OpenAI Agents SDK with all dependencies

​
2. Set OpenAI API Key

export OPENAI_API_KEY='your-api-key-here'
Get your API key from: https://platform.openai.com/api-keys

​
3. Deploy with Orpheus

cd examples/calculator-python
orpheus deploy .

​
Usage

​
Example Queries

Try these calculation requests: 
# Basic arithmetic
"Calculate 15 + 27"
"What's 144 divided by 12?"
"Multiply 7 and 8"

# Financial calculations
"What is the compound interest on $5000 at 3.5% for 8 years?"
"Calculate compound interest on $10000 at 5% annual rate for 10 years with quarterly compounding"

# Geometric calculations
"Find the area of a circle with radius 12"
"Calculate the area of a triangle with base 8 and height 6"

# Temperature conversions
"Convert 100 degrees Fahrenheit to Celsius"
"What is 0 Celsius in Kelvin?"
"Convert 98.6 F to C"

​
Testing with Orpheus

Once deployed, invoke the agent: 
orpheus invoke calculator-python '{"query": "What is the compound interest on $5000 at 3.5% for 8 years?"}'

​
Configuration

Agent settings from agent.yaml:
SettingValueDescription
runtimepython3Python runtime
modulecalculatorcalculator.py filename
entrypointhandlerHandler function name
memory256MBMemory allocation
timeout180sRequest timeout

​
Tool Details

​
add_numbers(a, b)

Adds two numbers and returns the result.
Example: add_numbers(5, 3) → 8

​
subtract_numbers(a, b)

Subtracts b from a.
Example: subtract_numbers(10, 4) → 6

​
multiply_numbers(a, b)

Multiplies two numbers.
Example: multiply_numbers(6, 7) → 42

​
divide_numbers(a, b)

Divides a by b with zero-check.
Example: divide_numbers(100, 4) → 25
Returns error if b = 0

​
calculate_compound_interest(principal, rate, time, compounds_per_year=1)

Calculates compound interest using A = P(1 + r/n)^(nt)
- principal: Initial amount ($)
- rate: Annual interest rate (% or decimal)
- time: Time period (years)
- compounds_per_year: Compounding frequency (default: 1 = annually)

Example: calculate_compound_interest(5000, 3.5, 8, 1)
Returns: "Principal: $5,000.00, Final Amount: $6,539.95, Interest Earned: $1,539.95"

​
calculate_circle_area(radius)

Calculates area of a circle: A = πr²
Example: calculate_circle_area(10)
Returns: "Circle with radius 10 has area 314.16 square units"

​
calculate_triangle_area(base, height)

Calculates area of a triangle: A = ½ × base × height
Example: calculate_triangle_area(10, 5)
Returns: "Triangle with base 10 and height 5 has area 25.00 square units"

​
convert_temperature(temperature, from_unit, to_unit)

Converts temperature between units.
Supported units: Celsius (C), Fahrenheit (F), Kelvin (K)

Examples:
- convert_temperature(100, "F", "C") → "100° Fahrenheit = 37.78°C"
- convert_temperature(0, "C", "K") → "0° Celsius = 273.15K"

​
Error Handling

The agent handles errors gracefully:
  • Missing query: Returns error with usage instructions
  • Division by zero: Tool returns error message
  • Invalid values: Tools validate inputs (negative radius, etc.)
  • API failures: Handler catches exceptions and returns error dict

​
File Structure

calculator-python/
├── calculator.py    # Agent implementation with handler
├── agent.yaml       # Orpheus configuration
├── requirements.txt # Python dependencies
└── README.md        # This file

​
Troubleshooting

​
Agent fails with “OPENAI_API_KEY not found”

Set the environment variable before starting the server: 
export OPENAI_API_KEY='sk-...'

​
Timeout errors

Increase timeout in agent.yaml if calculations take longer than 60s: 
timeout: 120  # 2 minutes

​
Import errors

Run setup.sh to install dependencies: 
cd examples/calculator-agent
./setup.sh

​
Next Steps

  1. Deploy the agent: orpheus deploy .
  2. Test with example queries above
  3. Try more complex calculations and tool combinations

​
Source Code

name: calculator-python
runtime: python3
module: calculator
entrypoint: handler
memory: 256
timeout: 180

# Environment variables
env:
    - OPENAI_API_KEY=sk-proj-**********************

# Telemetry configuration - custom labels for Prometheus filtering
telemetry:
  enabled: true
  labels:
    team: platform
    tier: basic
    use_case: math

# Scaling configuration
scaling:
    min_workers: 1
    max_workers: 50
    target_utilization: 1.5
    scale_up_threshold: 2.0
    scale_down_threshold: 0.3
    scale_up_delay: "10s"
    scale_down_delay: "30s"
    queue_size: 200