Documentation Index
Fetch the complete documentation index at: https://docs.orpheus.run/llms.txt
Use this file to discover all available pages before exploring further.
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
openai-agents - OpenAI Agents SDK with all dependencies
2. Set OpenAI API Key
export OPENAI_API_KEY='your-api-key-here'
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 |
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:
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
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
