Skip to content

fix: add retry_options to Quick Start to handle transient 503 errors#6059

Open
KellySit wants to merge 1 commit into
google:mainfrom
KellySit:fix/issue-5937
Open

fix: add retry_options to Quick Start to handle transient 503 errors#6059
KellySit wants to merge 1 commit into
google:mainfrom
KellySit:fix/issue-5937

Conversation

@KellySit

Copy link
Copy Markdown

Link to Issue or Description of Change

Issue 5937: #5937

Problem:
Went through a quick start and experienced the following error:
errorCode : "ServerError" errorMessage : "503 UNAVAILABLE. {'error': {'code': 503, 'message': 'This model is currently experiencing high demand. Spikes in demand are usually temporary. Please try again later.', 'status': 'UNAVAILABLE'}}"

Solution:
. Updated adk-python/README.md
Change the Quick Start "Agent" example to use the Gemini model class with retry_options instead of a bare model string.

  1. Updated adk-python/contributing/samples/core/quickstart/agent.py
    Similarly update the quickstart sample to use Gemini with retry_options so it matches the README and serves as a working reference.

Testing Plan

Unit Tests:

  • [Y] All unit tests pass locally.
    Manual End-to-End (E2E) Tests:
    Just follow the changed quick start guidelines, even if the model is in high demand, now it should be able to automatically retry and avoid transient 503 errors.

Checklist

  • [ Y] I have read the CONTRIBUTING.md document.
  • [ Y] I have performed a self-review of my own code.
  • [ Y] I have commented my code, particularly in hard-to-understand areas.
  • [ Y] I have added tests that prove my fix is effective or that my feature works.
  • [ Y] New and existing unit tests pass locally with my changes.
  • [ Y] I have manually tested my changes end-to-end.
  • [ Y] Any dependent changes have been merged and published in downstream modules.

Additional context

@google-cla

google-cla Bot commented Jun 10, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@adk-bot adk-bot added the documentation [Component] This issue is related to documentation, it will be transferred to adk-docs label Jun 10, 2026
@adk-bot

adk-bot commented Jun 10, 2026

Copy link
Copy Markdown
Collaborator

Response from ADK Triaging Agent

Hello @KellySit, thank you for creating this PR!

This PR looks great and has been labeled as documentation! However, it seems like the Contributor License Agreement (CLA) check is currently failing.

Before we can review and accept your contributions, please make sure you sign the Google Contributor License Agreement as detailed in the Contribution Guidelines.

If you have already signed it, please ensure your git commit email matches the email associated with your signed CLA.

Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation [Component] This issue is related to documentation, it will be transferred to adk-docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants