Back to catalog / Agent reliability
Retry workflow nodes only for selected transient exceptions
Set attempts, backoff, and an exception allowlist for one unreliable node; do not retry business denials.
Goal
Recover from retryable node failures without amplifying outages or duplicating side effects.
Steps
- Confirm the node is idempotent or deduplicated before enabling retries. [retry]
- Allowlist only transient connection or timeout failures; exclude argument and permission errors. [retry]
- Use
RetryConfig(max_attempts=3, initial_delay=1.0, backoff_factor=2.0, exceptions=[ConnectionError, "TimeoutError"])to retry only selected failures. [retry] - Inject transient and permanent failures; verify errors remain traceable and writes are not duplicated. [retry]
How to verify
Transient errors recover within the limit, permanent errors fail at the cap, and non-idempotent writes are not replayed.
Troubleshooting
If retries worsen throttling, increase backoff and reduce concurrency; disable retries first if side effects duplicate.
Permissions
Prerequisites
- Python 3.11+, google-adk compatible with the pinned revision, and an isolated test environment
- Configured model-provider credentials for live inference; never place them in code or logs
Permissions
- Use authorized test data only; isolate sessions and credentials per user; obtain human authorization before external side effects
Limitations
This procedure follows Google ADK at the pinned revision; other versions, models, or remote services may differ in APIs and event semantics. Recheck permissions, retention, and recovery before production.
Pinned upstream source
- Repository
- google/adk-python
- File path
- docs/guides/workflow/retry_config/index.md
- Pinned commit
e9b74d36140f2594b24c481fb7a3825b2cb01e96- Source checked
- 2026-10-14 · Reviewed against the pinned upstream source
Repository metrics
These values describe the upstream repository, not popularity or likes for an individual skill or playbook.
- Stars
- Not collected
- Forks
- Not collected
- Observed at
- Not collected
No metrics snapshot is available yet.
License: Apache-2.0
Main topic
Turn ecommerce campaign materials into a reviewable weekly brief