Legacy Agent Parameters

The Agent() constructor still accepts seven older parameters; each has a Config replacement that groups related settings.

from praisonaiagents import Agent, ExecutionConfig

# Old (still works, emits DeprecationWarning)
agent = Agent(name="coder", allow_code_execution=True, code_execution_mode="safe")

# New (preferred)
agent = Agent(
    name="coder",
    execution=ExecutionConfig(code_execution=True, code_mode="safe"),
)

Quick Start

Find the old params

Scan your code for any of the seven deprecated names:

grep -E 'allow_delegation|allow_code_execution|code_execution_mode|auto_save|rate_limiter|verification_hooks|cli_backend'

Look up the replacement

Match each name to its config object in the migration table below.

Swap the kwarg for the config object

The behaviour is identical — the config form just groups related settings.

Migration Table

Each deprecated param maps to one config-object replacement.

Deprecated param	Old default	Replacement (public API)
`allow_delegation`	`False`	`handoffs=[...]`
`allow_code_execution`	`False`	`execution=ExecutionConfig(code_execution=True)`
`code_execution_mode`	`"safe"`	`execution=ExecutionConfig(code_mode="safe")` (or `"unsafe"`)
`auto_save`	`None`	`memory=MemoryConfig(auto_save="name")`
`rate_limiter`	`None`	`execution=ExecutionConfig(rate_limiter=obj)`
`verification_hooks`	`None`	`autonomy=AutonomyConfig(verification_hooks=[...])`
`cli_backend`	`None`	`runtime=...` (see Runtime)

allow_delegation → handoffs

from praisonaiagents import Agent

other = Agent(name="specialist")
agent = Agent(name="router", allow_delegation=True)

from praisonaiagents import Agent

other = Agent(name="specialist")
agent = Agent(name="router", handoffs=[other])

allow_code_execution + code_execution_mode → execution

from praisonaiagents import Agent

agent = Agent(
    name="coder",
    allow_code_execution=True,
    code_execution_mode="safe",
)

from praisonaiagents import Agent, ExecutionConfig

agent = Agent(
    name="coder",
    execution=ExecutionConfig(code_execution=True, code_mode="safe"),
)

auto_save → memory

from praisonaiagents import Agent

agent = Agent(name="assistant", auto_save="session")

from praisonaiagents import Agent, MemoryConfig

agent = Agent(name="assistant", memory=MemoryConfig(auto_save="session"))

rate_limiter → execution

from praisonaiagents import Agent

agent = Agent(name="worker", rate_limiter=my_limiter)

from praisonaiagents import Agent, ExecutionConfig

agent = Agent(name="worker", execution=ExecutionConfig(rate_limiter=my_limiter))

verification_hooks → autonomy

from praisonaiagents import Agent

agent = Agent(name="auditor", verification_hooks=[check_output])

from praisonaiagents import Agent, AutonomyConfig

agent = Agent(name="auditor", autonomy=AutonomyConfig(verification_hooks=[check_output]))

cli_backend → runtime

from praisonaiagents import Agent

agent = Agent(name="cli-agent", cli_backend="claude-code")

from praisonaiagents import Agent

agent = Agent(name="cli-agent", runtime="claude-code")

What Else Changed

Two related rules make constructor mistakes fail fast instead of silently. Keyword-only after toolsets=. handoffs= and every Config param must be passed by name. A stray positional past toolsets no longer binds to handoffs= by accident.

from praisonaiagents import Agent

# TypeError — stray positional past toolsets cannot misbind to handoffs=
Agent("n", "r", "g", "b", "i", None, None, None, None, None, None, None, True)

Unknown kwargs now raise TypeError. Typos fail loudly.

from praisonaiagents import Agent

# TypeError: Agent.__init__() got unexpected keyword argument(s): totally_unknown
Agent(name="x", totally_unknown=1)

The visible signature shrank from 48 to 41 params. No public param was removed — only their documentation surface.

Should I Migrate?

Use this flow to decide when to switch.

Common Patterns

The three migrations you will hit most often. Coder agent — allow_code_execution + code_execution_mode → ExecutionConfig:

from praisonaiagents import Agent, ExecutionConfig

agent = Agent(
    name="coder",
    execution=ExecutionConfig(code_execution=True, code_mode="safe"),
)

Long-running agent — auto_save + rate_limiter → MemoryConfig + ExecutionConfig:

from praisonaiagents import Agent, MemoryConfig, ExecutionConfig

agent = Agent(
    name="worker",
    memory=MemoryConfig(auto_save="session"),
    execution=ExecutionConfig(rate_limiter=my_limiter),
)

Autonomous agent — verification_hooks → AutonomyConfig:

from praisonaiagents import Agent, AutonomyConfig

agent = Agent(
    name="auditor",
    autonomy=AutonomyConfig(verification_hooks=[check_output]),
)

Best Practices

Prefer the Config form in new code

The deprecated names will be removed in a future release. Write new agents with the config objects from the start.

Fix DeprecationWarnings as they surface

Migrate the warnings that appear in your test suite as you touch each agent, not all at once.

Always pass Config params by name

Never pass Agent(..., value) positionally past toolsets=. Keyword form prevents accidental misbinding.

Do not use fallback_models= on Agent()

fallback_models= is an internal forwarding path for clone_for_channel(), not a public param. Use llm=LLMConfig(fallback_models=[...]) instead.

Handoffs

Replaces allow_delegation=True.

Execution

Replaces allow_code_execution, code_execution_mode, and rate_limiter.

Autonomy

Replaces verification_hooks=[...].

Memory

Replaces auto_save="name".

Runtime

Replaces cli_backend=.

Rate Limiter

Replaces rate_limiter= on Agent().

Getting Started

Install

Core Concepts

Guides

Features

Models

Databases

Observability

Memory

Telemetry & Analytics

Knowledge

RAG

Persistence

Tools

Other Features

Developers

Configuration

Best Practices

Getting Started (No Code)

Legacy Agent Parameters

Quick Start

Migration Table

allow_delegation → handoffs

allow_code_execution + code_execution_mode → execution

auto_save → memory

rate_limiter → execution

verification_hooks → autonomy

cli_backend → runtime

What Else Changed

Should I Migrate?

Common Patterns

Best Practices

Handoffs

Execution

Autonomy

Memory

Runtime

Rate Limiter

​Quick Start

​Migration Table

​allow_delegation → handoffs

​allow_code_execution + code_execution_mode → execution

​auto_save → memory

​rate_limiter → execution

​verification_hooks → autonomy

​cli_backend → runtime

​What Else Changed

​Should I Migrate?

​Common Patterns

​Best Practices

​Related

Handoffs

Execution

Autonomy

Memory

Runtime

Rate Limiter

Quick Start

Migration Table

allow_delegation → handoffs

allow_code_execution + code_execution_mode → execution

auto_save → memory

rate_limiter → execution

verification_hooks → autonomy

cli_backend → runtime

What Else Changed

Should I Migrate?

Common Patterns

Best Practices

Related