Reliability

Make agents resilient: retry jitter, workflow timeouts, and task failure policies

Make agents survive flaky LLMs, hung workflows, and broken callbacks with built-in retry jitter and configurable failure policies.

from praisonaiagents import Agent, Task, PraisonAIAgents

task = Task(
    description="Summarise the article",
    fail_on_callback_error=True,
    fail_on_memory_error=False,
)

workflow = PraisonAIAgents(
    agents=[Agent(name="Writer", instructions="Summarise clearly")],
    tasks=[task],
    workflow_timeout=120,
)
workflow.start()

The user starts a workflow; retries, timeouts, and failure policies keep flaky LLM or callback errors from aborting the run.

Quick Start

1. Simple Usage

   from praisonaiagents import Agent, Task, PraisonAIAgents
   
   task = Task(
       description="Summarise the article",
       fail_on_callback_error=True,
       fail_on_memory_error=False,
   )
   
   workflow = PraisonAIAgents(
       agents=[Agent(name="Writer", instructions="Summarise clearly")],
       tasks=[task],
       workflow_timeout=120,
   )
   workflow.start()

2. With Configuration

   Strict mode for CI; lenient mode for production with non-fatal error inspection:

   from praisonaiagents import Agent, Task, PraisonAIAgents
   
   strict_task = Task(
       description="Validate the output",
       fail_on_callback_error=True,
       fail_on_memory_error=True,
   )
   
   lenient_task = Task(
       description="Generate content",
       fail_on_callback_error=False,
       fail_on_memory_error=False,
   )
   
   workflow = PraisonAIAgents(
       agents=[Agent(name="Validator", instructions="Check quality")],
       tasks=[strict_task, lenient_task],
       workflow_timeout=300,
   )
   
   result = workflow.start()
   if result.non_fatal_errors:
       logger.warning(f"Non-fatal errors: {result.non_fatal_errors}")

How It Works

Configuration Options

Retry categories

Jitter is automatic — there is no flag to turn it off.

Common Patterns

Strict CI mode

task = Task(
    description="Validate output",
    fail_on_callback_error=True,
    fail_on_memory_error=True,
)
workflow = PraisonAIAgents(tasks=[task], workflow_timeout=60)

Lenient production mode

result = workflow.start()
for error in result.non_fatal_errors:
    metrics.increment("task.non_fatal_error", tags={"error_type": type(error).__name__})

Multi-agent fan-out

agents = [Agent(name=f"Worker-{i}") for i in range(10)]
# Jitter prevents thundering herd — no config needed

Best Practices

Related