Skip to main content

​
Overview

PraisonAI v1.0 introduces a consistent Agent* prefix naming convention for core orchestration classes. This makes the API more intuitive and agent-centric.
Backward Compatible: All old names continue to work as silent aliases. No code changes are required for existing projects.

​
What Changed

AgentTeam

Manages a team of agents working together on tasks.Old: AgentManager, Agents

AgentFlow

Defines step-by-step workflows with routing and patterns.Old: Workflow, Pipeline

AgentOSProtocol

Protocol for production deployment of agents.Old: AgentAppProtocol

AgentOSConfig

Configuration for AgentOS deployments.Old: AgentAppConfig

​
Quick Reference

Old NameNew NamePurpose
AgentManagerAgentTeamMulti-agent orchestration
AgentsAgentTeamMulti-agent orchestration
WorkflowAgentFlowStep-based workflows
PipelineAgentFlowStep-based workflows
AgentAppProtocolAgentOSProtocolDeployment protocol
AgentAppConfigAgentOSConfigDeployment config

​
Migration Examples

from praisonaiagents import Agent, Agents

agent1 = Agent(name="researcher", instructions="Research topics")
agent2 = Agent(name="writer", instructions="Write content")

team = Agents(agents=[agent1, agent2])
result = team.start()

​
No Breaking Changes

All old names work exactly as before. They are silent aliases with no deprecation warnings.
# Both work identically
from praisonaiagents import AgentManager  # ✓ Still works (silent alias)
from praisonaiagents import AgentTeam     # ✓ New recommended name

# They are the same class
assert AgentManager is AgentTeam  # True

​
Why the Change?

All orchestration classes now follow the Agent* prefix pattern, making the API more predictable.
  • AgentTeam clearly indicates a team of agents
  • AgentFlow clearly indicates a flow/workflow of agent steps
  • AgentOS clearly indicates an operating system for agents
The naming reinforces that PraisonAI is an agent-first framework where everything revolves around agents.
1

No Immediate Action Required

Your existing code will continue to work without any changes.
2

Update New Code

Use the new names (AgentTeam, AgentFlow, AgentOSProtocol) in new projects.
3

Gradual Migration

When updating existing code, switch to the new names for consistency.

​
Class Hierarchy

​
Need Help?

Documentation

Learn more about agents and orchestration

Examples

See working examples with the new names