Praison AI

Execute Async • AI Agent SDK

execute_async: Execute typed handoff asynchronously with schema validation.

execute_async

Async

Method

</div>

This is a method of the TypedHandoff class in the handoff module.

Execute typed handoff asynchronously with schema validation.

Signature

python
async def execute_async(source_agent: 'Agent', payload: Union[T, dict, str], context: Optional[Dict[str, Any]]) -> HandoffResult

Parameters

ParamField Agent

The agent initiating the handoff

ParamField Union[T, dict, str]

The typed payload (Pydantic model instance or dict) OR a string prompt (for backward compatibility)

ParamField Optional

Optional additional context

Returns

ResponseField HandoffResult

HandoffResult with response or error

Exceptions

HandoffValidationError

If payload validation fails

Uses

  • execute_async
  • time.time
  • validated_payload.model_dump_json
  • json.dumps
  • logger.info
  • achat
  • asyncio.get_event_loop
  • loop.run_in_executor
  • HandoffResult
  • asyncio.wait_for

Used By

Source

View on GitHub

praisonaiagents/agent/handoff.py at line 1770

Related Documentation

Async Feature Background Tasks Async Jobs