Migration Guide v1.0
Migrate to the new Agent* prefix naming convention
Overview
PraisonAI v1.0 introduces a consistent Agent\* prefix naming convention for core orchestration classes. This makes the API more intuitive and agent-centric.
What Changed
Manages a team of agents working together on tasks.
Old: AgentManager, Agents
Defines step-by-step workflows with routing and patterns.
Old: Workflow, Pipeline
Protocol for production deployment of agents.
Old: AgentAppProtocol
Configuration for AgentOS deployments.
Old: AgentAppConfig
Quick Reference
| Old Name | New Name | Purpose |
|---|---|---|
AgentManager | AgentTeam | Multi-agent orchestration |
Agents | AgentTeam | Multi-agent orchestration |
Workflow | AgentFlow | Step-based workflows |
Pipeline | AgentFlow | Step-based workflows |
AgentAppProtocol | AgentOSProtocol | Deployment protocol |
AgentAppConfig | AgentOSConfig | Deployment config |
Migration Examples
Python
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()from praisonaiagents import Agent, AgentTeam
agent1 = Agent(name="researcher", instructions="Research topics")
agent2 = Agent(name="writer", instructions="Write content")
team = AgentTeam(agents=[agent1, agent2])
result = team.start()TypeScript
import { Agent, Agents } from 'praisonai';
const researcher = new Agent({ instructions: "Research topics" });
const writer = new Agent({ instructions: "Write content" });
const team = new Agents([researcher, writer]);
await team.start();import { Agent, AgentTeam } from 'praisonai';
const researcher = new Agent({ instructions: "Research topics" });
const writer = new Agent({ instructions: "Write content" });
const team = new AgentTeam([researcher, writer]);
await team.start();AgentFlow
from praisonaiagents import Workflow
flow = Workflow(steps=[...])
result = flow.start()from praisonaiagents import AgentFlow
flow = AgentFlow(steps=[...])
result = flow.start()import { Workflow } from 'praisonai';
const flow = new Workflow('my-workflow');
await flow.run(input);import { AgentFlow } from 'praisonai';
const flow = new AgentFlow('my-workflow');
await flow.run(input);No Breaking Changes
# 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 # TrueWhy the Change?
Consistency
All orchestration classes now follow the Agent* prefix pattern, making the API more predictable.
Clarity
- AgentTeam clearly indicates a team of agents
- AgentFlow clearly indicates a flow/workflow of agent steps
- AgentOS clearly indicates an operating system for agents
Agent-Centric
The naming reinforces that PraisonAI is an agent-first framework where everything revolves around agents.
Recommended Actions
- No Immediate Action Required
Your existing code will continue to work without any changes.
- Update New Code
Use the new names (
AgentTeam,AgentFlow,AgentOSProtocol) in new projects. - Gradual Migration
When updating existing code, switch to the new names for consistency.