Different Ways to Create Tools

def calculator_tool(expression: str) -> float:
    """Evaluate a mathematical expression.
    
    Args:
        expression: Math expression to evaluate
        
    Returns:
        Result of the calculation
    """
    return eval(expression)

from praisonaiagents import Agent

agent = Agent(
    name="calculator",
    tools=[calculator_tool]
)

# Simple lambda tool
uppercase_tool = lambda text: text.upper()
uppercase_tool.__doc__ = "Convert text to uppercase"
uppercase_tool.__annotations__ = {"text": str, "return": str}

agent = Agent(
    name="formatter",
    tools=[uppercase_tool]
)

import requests

def http_get_tool(url: str) -> dict:
    """Make HTTP GET request.
    
    Args:
        url: URL to fetch
        
    Returns:
        Response data as dictionary
    """
    response = requests.get(url)
    return {
        "status": response.status_code,
        "content": response.text[:1000]
    }

agent = Agent(
    name="http_agent",
    tools=[http_get_tool]
)

# tools.py

def file_reader(path: str) -> str:
    """Read file contents.
    
    Args:
        path: Path to file
        
    Returns:
        File contents
    """
    with open(path, 'r') as f:
        return f.read()

def file_writer(path: str, content: str) -> bool:
    """Write content to file.
    
    Args:
        path: Path to file
        content: Content to write
        
    Returns:
        Success status
    """
    with open(path, 'w') as f:
        f.write(content)
    return True

# agents.yaml
roles:
  file_agent:
    tools:
      - file_reader
      - file_writer

my_tools/
├── __init__.py
├── search.py
└── database.py

# my_tools/search.py

def web_search(query: str) -> list:
    """Search the web.
    
    Args:
        query: Search query
        
    Returns:
        List of results
    """
    return [{"title": "Result", "url": "https://example.com"}]

# my_tools/__init__.py
from .search import web_search
from .database import db_query

__all__ = ["web_search", "db_query"]

# TEMPLATE.yaml
requires:
  tools_sources:
    - my_tools

from praisonaiagents import tool

@tool
def decorated_tool(query: str) -> str:
    """A decorated tool function.
    
    Args:
        query: Input query
        
    Returns:
        Processed result
    """
    return f"Processed: {query}"

agent = Agent(
    name="decorated_agent",
    tools=[decorated_tool]
)

praisonai tools add pandas

praisonai tools add ./my_tools.py

praisonai tools add github:user/repo/tools

praisonai tools list