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:

Setting	Value	Description
runtime	python3	Python runtime
module	calculator	calculator.py filename
entrypoint	handler	Handler function name
memory	256MB	Memory allocation
timeout	180s	Request 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

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

Source Code

agent.yaml

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

Getting Started

Guides

Concepts

Reference

Examples

Troubleshooting

Python Calculator

Calculator Agent

Features

Basic Arithmetic

Financial Calculations

Geometric Calculations

Unit Conversions

Setup

1. Install Dependencies

2. Set OpenAI API Key

3. Deploy with Orpheus

Usage

Example Queries

Testing with Orpheus

Configuration

Tool Details

add_numbers(a, b)

subtract_numbers(a, b)

multiply_numbers(a, b)

divide_numbers(a, b)

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

calculate_circle_area(radius)

calculate_triangle_area(base, height)

convert_temperature(temperature, from_unit, to_unit)

Error Handling

File Structure

Troubleshooting

Agent fails with “OPENAI_API_KEY not found”

Timeout errors

Import errors

Next Steps

Source Code

​Calculator Agent

​Features

​Basic Arithmetic

​Financial Calculations

​Geometric Calculations

​Unit Conversions

​Setup

​1. Install Dependencies

​2. Set OpenAI API Key

​3. Deploy with Orpheus

​Usage

​Example Queries

​Testing with Orpheus

​Configuration

​Tool Details

​add_numbers(a, b)

​subtract_numbers(a, b)

​multiply_numbers(a, b)

​divide_numbers(a, b)

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

​calculate_circle_area(radius)

​calculate_triangle_area(base, height)

​convert_temperature(temperature, from_unit, to_unit)

​Error Handling

​File Structure

​Troubleshooting

​Agent fails with “OPENAI_API_KEY not found”

​Timeout errors

​Import errors

​Next Steps

​Source Code

Calculator Agent

Features

Basic Arithmetic

Financial Calculations

Geometric Calculations

Unit Conversions

Setup

1. Install Dependencies

2. Set OpenAI API Key

3. Deploy with Orpheus

Usage

Example Queries

Testing with Orpheus

Configuration

Tool Details

add_numbers(a, b)

subtract_numbers(a, b)

multiply_numbers(a, b)

divide_numbers(a, b)

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

calculate_circle_area(radius)

calculate_triangle_area(base, height)

convert_temperature(temperature, from_unit, to_unit)

Error Handling

File Structure

Troubleshooting

Agent fails with “OPENAI_API_KEY not found”

Timeout errors

Import errors

Next Steps

Source Code