> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Handoff Error • AI Agent SDK

> HandoffError: Agent handoff/delegation failed.

# HandoffError

> Defined in the [**errors**](../modules/errors) module.

<Badge color="blue">AI Agent</Badge>

Agent handoff/delegation failed.

Includes source/target agent context for multi-agent debugging.

## Constructor

<ParamField query="message" type="str" required={true}>
  No description available.
</ParamField>

<ParamField query="source_agent" type="str" required={false} default="'unknown'">
  No description available.
</ParamField>

<ParamField query="target_agent" type="Optional[str]" required={false}>
  No description available.
</ParamField>

<ParamField query="agent_id" type="str" required={false} default="'unknown'">
  No description available.
</ParamField>

<ParamField query="run_id" type="Optional[str]" required={false}>
  No description available.
</ParamField>

<ParamField query="error_category" type="AgentErrorKind" required={false} default="'unknown'">
  No description available.
</ParamField>

<ParamField query="is_retryable" type="bool" required={false} default="False">
  No description available.
</ParamField>

<ParamField query="context" type="Optional" required={false}>
  No description available.
</ParamField>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/errors.py#L333">
  `praisonaiagents/errors.py` at line 333
</Card>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Handoffs Concept" icon="hand-holding" href="/docs/docs/concepts/handoffs" />

  <Card title="Handoffs Feature" icon="arrow-right-arrow-left" href="/docs/docs/features/handoffs" />
</CardGroup>