handoff • AI Agent SDK

Handoff functionality for agent-to-agent delegation.

handoff

AI Agent

Handoff functionality for agent-to-agent delegation.

This module provides handoff capabilities that allow agents to delegate tasks to other agents, similar to the OpenAI Agents SDK implementation.

Unified Handoff System:

• Handoff: LLM-driven (tool call) or programmatic agent-to-agent transfer
• HandoffConfig: Configuration for context policy, timeouts, concurrency, safety
• Replaces/absorbs Agent.delegate() and SubagentDelegator functionality

Import

from praisonaiagents.agent import handoff

Classes

ContextPolicy

Policy for context sharing during handoff.

HandoffConfig

Unified configuration for handoff behavior.

HandoffError

Base exception for handoff errors.

HandoffCycleError

Raised when a cycle is detected in handoff chain.

HandoffDepthError

Raised when max handoff depth is exceeded.

HandoffTimeoutError

Raised when handoff times out.

HandoffInputData

Data passed to a handoff target agent.

HandoffResult

Result of a handoff operation.

Handoff

Represents a handoff configuration for delegating tasks to another agent.

handoff_filters

Common handoff input filters.

Functions

handoff()

Create a handoff configuration for delegating tasks to another agent.

prompt_with_handoff_instructions()

Add handoff instructions to an agent’s prompt.

Constants

Name	Value
RECOMMENDED_PROMPT_PREFIX	'You have the ability to transfer tasks to specialized agents when appropriate. \nWhen you determine that a task would be better handled by another agent with specific expertise, \nuse the transfer to...

---

Related Documentation

Handoffs Concept

Handoffs Feature