Skip to main content

Agent Recipes Troubleshooting

Common issues and solutions when working with Agent Recipes.

Diagnostic Commands

Check All Dependencies

Verify API Keys

List Available Recipes

Common Issues

1. Missing API Key

Error:
Solution:

2. Missing External Tool (ffmpeg)

Error:
Solution:

3. Missing External Tool (tesseract)

Error:
Solution:

4. Missing Python Package

Error:
Solution:

5. API Rate Limit

Error:
Solution:

6. Invalid Model Name

Error:
Solution:

7. Recipe Not Found

Error:
Solution:

8. Permission Denied

Error:
Solution:

9. Memory Error with Large Files

Error:
Solution:

10. Timeout Error

Error:
Solution:

Debug Mode

Enable Verbose Logging

Inspect Recipe Configuration

Getting Help

Check Documentation

Report Issues

If you encounter a bug:
  1. Check existing issues: GitHub Issues
  2. Include:
    • Recipe name and version
    • Full error message
    • Python version (python --version)
    • OS and version
    • Steps to reproduce

Community Support

Next Steps