Tools Guide

Complete guide to working with PraisonAI tools

Next

Tools let agents read data, call APIs, and run code—this hub links every tools how-to.

from praisonaiagents import Agent, tool

@tool
def ping() -> str:
    """Health check tool."""
    return "pong"

agent = Agent(name="Tools Intro", tools=[ping])
agent.start("Run the ping tool.")

The user follows a tools guide, attaches capabilities to agents, and validates behaviour with doctor.

Quick Start

1. Simple Usage

   Decorate a function with @tool and hand it to an agent.

   from praisonaiagents import Agent, tool
   
   @tool
   def ping() -> str:
       """Health check tool."""
       return "pong"
   
   agent = Agent(name="Tools Intro", tools=[ping])
   agent.start("Run the ping tool.")

2. With Configuration

   Add tools from a package or file with the CLI, then verify resolution.

   praisonai tools add ./my_tools.py
   praisonai tools doctor

How It Works

Tools Guides

Learn how to create, configure, debug, and manage tools in PraisonAI.

Quick Reference

Best Practices