agent_tools/README.md

Agent Tools

This directory contains user-defined tools for the agent framework.

Structure

agent_tools/
├── __init__.py          # Exports all tools
├── file_tools.py        # File operation tools (unzip, etc.)
├── web_tools.py         # Web-related tools (search, etc.)
├── data_tools.py        # Data processing tools
└── README.md            # This file

Adding New Tools

1. Create or edit a tool file (e.g., file_tools.py)
2. Use the @tool decorator from agent_framework:

from agent_framework import tool

@tool
def my_tool(param: str) -> str:
    """Tool description for the LLM."""
    # Your tool logic here
    return result

3. Export it in __init__.py:

from .file_tools import my_tool

__all__ = [
    "my_tool",
    # ... other tools
]

Using Tools with Agents

from agent_framework import Agent, LlmClient
from agent_tools import unzip_file  # Import your tools

# Create agent with tools
agent = Agent(
    model=LlmClient(model="gpt-5-mini"),
    tools=[unzip_file],  # Add your tools here
    instructions="You are a helpful assistant."
)

# Or import all tools
from agent_tools import *
all_tools = [unzip_file, ...]  # List all your tools

Tool Categories

File Tools (file_tools.py)

• unzip_file - Extract zip files

Web Tools (web_tools.py)

• (Add web-related tools here)

Data Tools (data_tools.py)

• (Add data processing tools here)