Skip to main content

​
praisonaiagents.agent.handoff

Core SDK 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

​
Overview

This module provides components for 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

NameValue
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...