Skip to main content

​
Configuration Reference

This section provides comprehensive documentation for all configuration options in PraisonAI. Each component has its own detailed configuration guide with examples, best practices, and advanced options.

​
Configuration Categories

Agent Configuration

Complete guide to agent parameters including max_iter, max_retry_limit, context_length, and markdown options

Task Configuration

Task parameters including task_type, condition, next_tasks, and is_start options

Memory Configuration

Memory system configuration including graph store, quality scores, and embedder options

LLM Configuration

LLM settings including retry logic, timeouts, and custom headers

Tool Configuration

Tool timeout settings and performance tuning options

Handoff Configuration

Handoff filters and advanced delegation settings

Guardrail Configuration

Custom validation rules and guardrail settings

Best Practices

Configuration best practices and common patterns

​
Quick Reference

​
Essential Configuration Parameters

ComponentParameterTypeDescription
Agentmax_iterintMaximum iterations for task completion
Agentmax_retry_limitintMaximum retries for failed operations
Tasktask_typestrType of task execution
Memoryquality_thresholdfloatMinimum quality score for memory retrieval
LLMtimeoutintRequest timeout in seconds
Toolexecution_timeoutintTool execution timeout

​
Environment Variables

PraisonAI supports configuration through environment variables for sensitive settings: 
# LLM Configuration
export OPENAI_API_KEY="your-api-key"
export OPENAI_MODEL="gpt-4o"

# Memory Configuration
export PRAISONAI_MEMORY_PROVIDER="rag"
export PRAISONAI_DB_PATH="/path/to/db"

# Performance Settings
export PRAISONAI_MAX_WORKERS=4
export PRAISONAI_TIMEOUT=300

​
Configuration Files

PraisonAI supports YAML configuration files for complex setups: 
# config.yaml
agents:
  default:
    max_iter: 15
    max_retry_limit: 3
    context_length: 128000
    markdown: true

memory:
  provider: rag
  quality_threshold: 0.7
  graph_enabled: true

llm:
  timeout: 60
  max_retries: 3
  temperature: 0.7

​
Getting Started

  1. Start with the Agent Configuration to set up your agents
  2. Configure Tasks for your workflow
  3. Set up Memory for persistent storage
  4. Fine-tune LLM settings for optimal performance

​
Need Help?