Skip to main content
Orpheus supports tasks that run for 30+ minutes.

Configure Timeout

Set the timeout in your agent.yaml:

Example: Long Analysis Task

Run Long Tasks

The CLI waits for completion. For very long tasks, consider running in background.

Check Progress

While a task is running:

Handle Failures

Long tasks are more likely to fail. Use workspace to save progress:
If the task fails, retry it - already-processed documents are skipped.

Timeout vs Memory

Best Practices

  1. Save progress incrementally - Don’t lose work on failure
  2. Log progress - Use print() for visibility
  3. Set realistic timeout - Add buffer for API latency
  4. Use workspace for checkpoints - Resume after failures

Next: Scaling

Tune autoscaling for your workload →