Debug Recipes

Step-by-step guide to debugging and troubleshooting recipes

How to Debug Recipe Execution

1. Enable Verbose Mode

   praisonai recipe run my-recipe --verbose
   
2. Check Recipe Validation

   praisonai recipe validate ./my-recipe
   
3. View Recipe Info

   praisonai recipe info my-recipe
   
4. Check Tool Resolution

   praisonai tools list
   

How to Use Recipe Doctor

1. Run Doctor Command

   praisonai tools doctor
   
2. Review Diagnostics

   The doctor command will show:

   • Missing tools
   • Invalid tool references
   • Configuration issues
   • Dependency problems
3. Fix Issues

   Based on doctor output, fix the identified issues in your recipe files.

How to Debug Tool Resolution

1. List Available Tools

   praisonai tools list
   
2. Resolve Specific Tool

   praisonai tools resolve shell_tool
   

How to Debug with Python

1. Enable Debug Logging

   import logging
   logging.basicConfig(level=logging.DEBUG)
   
   from praisonaiagents import Agent
   
   agent = Agent(
       name="test",
       role="Test Agent",
       verbose=True
   )
   
2. Test Agent Execution

   result = agent.start("Test task")
   print(result)
   

Common Issues and Solutions

Issue	Cause	Solution
Tool not found	Tool not available	Check praisonai tools list
Variable undefined	Missing variable	Pass with --var key=value
Recipe not found	Wrong path	Use full path
Permission denied	File access	Check file permissions

Debug CLI Options

praisonai recipe run <recipe> [DEBUG OPTIONS]

Debug Options:
  --verbose              Enable verbose logging