Agent Wealth HubFree public resources
中文 EN العربية

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

  1. Confirm the node is idempotent or deduplicated before enabling retries. [retry]
  2. Allowlist only transient connection or timeout failures; exclude argument and permission errors. [retry]
  3. Use RetryConfig(max_attempts=3, initial_delay=1.0, backoff_factor=2.0, exceptions=[ConnectionError, "TimeoutError"]) to retry only selected failures. [retry]
  4. 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

Permissions

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

https://github.com/google/adk-python/blob/e9b74d36140f2594b24c481fb7a3825b2cb01e96/docs/guides/workflow/retry_config/index.md

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

Related resources