--auto flag automatically generates an agents.yaml configuration from a natural language task description, using intelligent tool discovery to assign the most appropriate tools based on task analysis.
Auto Mode vs Recipe Create: Auto mode generates and immediately executes agents. Use
praisonai recipe create if you want to generate a reusable recipe folder without execution.Quick Start
Auto Mode vs Recipe Create
Auto Mode
- Generates and executes immediately
- Creates
agents.yamlin current directory - Best for one-off tasks
- No optimization loop
Recipe Create
- Creates a reusable recipe folder
- Includes
agents.yaml+tools.py - Optimization loop for quality
- Best for reusable workflows
Usage
Options
| Option | Description |
|---|---|
--auto | Enable auto mode with task description |
--merge | Merge with existing agents.yaml instead of overwriting |
--framework | Framework adapter to use. Discovered dynamically from the adapter registry — built-in (ag2, autogen, autogen_v4, crewai, praisonai) and any installed third-party adapter (entry-point group praisonai.framework_adapters). |
Intelligent Tool Discovery
Auto mode sources tool suggestions from the canonicalToolResolver.list_available(), so only tools you actually have installed are surfaced.
Keyword hints still prioritise suggestions by task, but the recommended set is intersected with the installed registry before it reaches the prompt.
When the resolver is available, the generation prompt header reads “AVAILABLE TOOLS (installed)” and lists only installed tools. If the resolver cannot be constructed, auto mode falls back to keyword hints and the header reads “AVAILABLE TOOLS BY CATEGORY”.
The legacy AVAILABLE_TOOLS and TOOL_CATEGORIES remain importable from praisonai.auto for backward compatibility.
The enhanced auto mode analyzes your task description and automatically assigns appropriate tools from 9 categories:
| Category | Tools | Triggered By |
|---|---|---|
| Web Search | internet_search, tavily_search, exa_search | ”search”, “find”, “look up” |
| Web Scraping | scrape_page, crawl, extract_text | ”scrape”, “crawl”, “extract” |
| File Operations | read_file, write_file, list_files | ”read file”, “save”, “load” |
| Code Execution | execute_command, execute_code | ”execute”, “run code”, “script” |
| Data Processing | read_csv, write_csv, read_json | ”csv”, “excel”, “json”, “data” |
| Research | search_arxiv, wiki_search | ”research”, “paper”, “wikipedia” |
| Finance | get_stock_price, get_historical_data | ”stock”, “price”, “financial” |
| Math | evaluate, solve_equation | ”calculate”, “math”, “equation” |
| Database | query, find_documents | ”database”, “sql”, “mongodb” |
Examples
- Financial Research
- Web Scraping
- Data Analysis
- With Framework
- Merge Existing
get_stock_price, get_stock_info, get_historical_data, write_fileHow It Works
Task Complexity Analysis
Determines if task is simple (1 agent), moderate (2 agents), or complex (3-4 agents)
Auto Mode Providers
LiteLLM unlocks 100+ providers for auto mode, with automatic OpenAI fallback. Learn how provider selection works.
Generated Output
The auto mode creates anagents.yaml file with:
- Intelligent agent count based on task complexity
- Specialized roles with clear responsibilities
- Appropriate tools from 50+ available tools
- Focused tasks with expected outputs
- Process configuration (sequential, parallel, etc.)
When to Use Each
Use Auto Mode When...
Use Auto Mode When...
- You need a quick one-off task
- You want immediate execution
- You don’t need to save the workflow
- You’re prototyping ideas
Use Recipe Create When...
Use Recipe Create When...
- You want a reusable workflow
- You need optimization for quality
- You want to share the recipe
- You need custom tools in
tools.py - You want to version control the recipe