Tools

# List all available tools
praisonai tools list

# Get info about a specific tool
praisonai tools info internet_search

praisonai tools list

🔧 Available Tools:
--------------------------------------------------

  Search:
    • internet_search: Available
    • wikipedia_search: Search Wikipedia
    • arxiv_search: Search arXiv papers
    • tavily_search: Available

  File:
    • read_file: Available
    • write_file: Available
    • list_files: Available
    • csv_read: Read CSV files
    • json_read: Read JSON files
    • yaml_read: Read YAML files

  Code:
    • execute_code: Available
    • shell_command: Execute shell commands
    • calculator: Perform mathematical calculations

  Data:
    • pandas_query: Query data with Pandas
    • duckdb_query: SQL queries with DuckDB
    • yfinance: Financial market data

  Web:
    • crawl4ai: Web crawling
    • trafilatura: Web content extraction
    • duckduckgo: DuckDuckGo search

--------------------------------------------------
Total: 18 tools available

praisonai tools info internet_search

🔧 Tool: internet_search

┌─────────────────────┬────────────────────────────────────────────┐
│ Property            │ Value                                      │
├─────────────────────┼────────────────────────────────────────────┤
│ Name                │ internet_search                            │
│ Category            │ Search                                     │
│ Status              │ ✅ Available                               │
│ Dependencies        │ duckduckgo-search                          │
└─────────────────────┴────────────────────────────────────────────┘

Description:
  Perform internet searches using DuckDuckGo. Returns a list of
  search results with titles, URLs, and snippets.

Parameters:
  • query (str, required): The search query
  • max_results (int, optional): Maximum results to return (default: 5)

Example Usage:
  ```python
  from praisonaiagents import Agent

  agent = Agent(
      instructions="Search the web for information",
      tools=[internet_search]
  )
  agent.start("Search for AI news")

### Search Tools

```bash
praisonai tools search "web"

🔍 Searching tools for: "web"

Found 4 matching tools:

  1. crawl4ai
     Category: Web
     Description: Crawl and extract content from web pages

  2. trafilatura
     Category: Web
     Description: Extract main content from web pages

  3. internet_search
     Category: Search
     Description: Search the web using DuckDuckGo

  4. tavily_search
     Category: Search
     Description: AI-powered web search with Tavily

praisonai tools help

Tools Commands:

  praisonai tools list              - List all available tools
  praisonai tools info <name>       - Get detailed info about a tool
  praisonai tools search <query>    - Search for tools by name/description
  praisonai tools help              - Show this help

Using Tools with Agents:
  praisonai "task" --tools "tool1,tool2"   - Use specific tools
  praisonai "task" --tools tools.py        - Load tools from file

# Single tool
praisonai "Search for Python tutorials" --tools "internet_search"

# Multiple tools
praisonai "Research and calculate" --tools "internet_search,calculator"

# Create tools.py with custom tools
praisonai "Custom task" --tools tools.py

def my_custom_tool(query: str) -> str:
    """Custom tool description"""
    return f"Result for: {query}"

def another_tool(data: dict) -> dict:
    """Another custom tool"""
    return {"processed": data}

pip install duckduckgo-search tavily-python

# tools.py
from typing import List, Dict

def search_database(query: str, limit: int = 10) -> List[Dict]:
    """
    Search the internal database.
    
    Args:
        query: Search query string
        limit: Maximum results to return
        
    Returns:
        List of matching records
    """
    # Your implementation
    return results

praisonai "Find customer records" --tools tools.py