This is now the default framework. Running
praisonai agents.yaml without any framework flag uses this adapter.Need a framework that isn’t listed here? See Framework Adapter Plugins to register your own via Python entry points.
Installation
Quick Start
Advanced: With Tasks and Context
Execution Methods
| Method | Default Behavior | Use Case |
|---|---|---|
.start() | Verbose in TTY (shows Rich panels) | Interactive/beginner |
.run() | Silent (no output) | Production/scripts |
Output Control
Agent Configuration
Core Attributes
name: Agent’s identifierrole: Agent’s function/expertisegoal: Individual objectivebackstory: Context and personalityllm: Language model (default: OpenAI’s GPT-4)instructions: Agent instructions/system prompttools: List of tools available to the agent
Optional Attributes
tools: List of available toolsmemory: Enable memory capabilitiesknowledge: Knowledge base configurationplanning: Enable planning mode (default: False)reflection: Enable self-reflectionallow_delegation: ⚠️ Deprecated — usehandoffs=instead (default: False)handoffs: List of agents for handoff
Task Configuration
Core Attributes
description: Task detailsexpected_output: Desired outcomeagent: Assigned agent
Optional Attributes
context: Dependencies on other taskstools: Task-specific toolsasync_execution: Run asynchronously (default: False)output_file: Save output to filecallback: Post-task function
YAML config: Block
The PraisonAI adapter supports a top-level config: block in YAML that automatically wires InteractiveRuntime (ACP + LSP + agent-centric tools) into the agent execution.
| YAML Key | Type | Default | Effect |
|---|---|---|---|
acp | bool | False | Initializes InteractiveRuntime with ACP enabled. Agent-centric tools are loaded and merged into tools_dict before agents start. Runtime is torn down after team.start() returns. |
lsp | bool | False | Same as above but with LSP enabled. Can be combined with acp: true. |
PRAISONAI_APPROVAL_MODE environment variable (default: "prompt").
Example: YAML with ACP/LSP
config.acp and config.lsp only take effect for framework: praisonai. Other adapters (crewai, autogen, ag2, autogen_v4) ignore them.AgentOps Integration
Whenagentops is installed, the PraisonAI adapter automatically calls agentops.end_session("Success") after agent execution completes. No configuration required.
Advanced Features
Tool Integration
Custom Callbacks
Error Handling
The framework includes built-in error handling for:- API rate limits
- Token limits
- Task timeouts
- Tool execution failures
Best Practices
-
Agent Design
- Give clear, specific roles and goals
- Provide detailed backstories
- Use appropriate tools for tasks
-
Task Management
- Break complex tasks into subtasks
- Set clear dependencies
- Use async execution for independent tasks
-
Resource Optimization
- Enable caching when appropriate
- Set reasonable max_iter limits
- Use rate limiting for API calls
-
Error Handling
- Implement task callbacks
- Set appropriate timeouts
- Monitor execution logs
Parallel Execution (Upcoming)
Memory Management (Upcoming)
Troubleshooting
Unsupported framework error: If you seeUnsupported framework: praisonai. Registered: ['ag2', 'autogen', 'autogen_v4', 'crewai', 'praisonai'], check spelling — frameworks are registered via the adapter registry.
Missing installation error: If the framework is not installed, PraisonAI now fails fast at CLI entry with:
--framework is caught before any expensive setup runs.
