Documentation is missing for Search Grounding with DynamicRetrievalConfig in the new SDK.

[marqmarti]

Description of the bug:

I've been checking the docs for the new SDK, and in the Search Grounding section, I saw this:

Before

import google.generativeai as genai

model = genai.GenerativeModel('gemini-1.5-flash')
response = model.generate_content(
    contents="what is the Google stock price?",
    tools='google_search_retrieval'
)

After

from google import genai
from google.genai import types
client = genai.Client()

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents='What is the Google stock price?',
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                google_search=types.GoogleSearch()
            )
        ]
    )
)

However, the example does not explain how to use dynamic retrieval (DynamicRetrievalConfig).

I found this example in the yet-to-be-updated Gemini API Docs, but it clearly follows the old SDK structure.

from google import genai
from google.genai import types

client = genai.Client(api_key="GEMINI_API_KEY")

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Who won Wimbledon this year?",
    config=types.GenerateContentConfig(
        tools=[types.Tool(
            google_search=types.GoogleSearchRetrieval(
                dynamic_retrieval_config=types.DynamicRetrievalConfig(
                    dynamic_threshold=0.6))
        )]
    )
)
print(response)

Is it possible to include an example of how to use DynamicRetrievalConfig within the new SDK?

Actual vs expected behavior:

No response

Any other information you'd like to share?

No response

[yinghsienwu]

https://github.com/googleapis/python-genai/blob/main/google/genai/tests/models/test_generate_content_tools.py#L218
If urgent, this test case might be useful.

[jaycee-li]

Hi @marcsitelabs, thanks for raising this issue! GoogleSearchRetrieval is for Gemini 1.5 models only, GoogleSearch is for Gemini 2.0 models only. If you use the wrong one, you'll likely get an error message like this:

ClientError: 400 INVALID_ARGUMENT. {'error': {'code': 400, 'message': 'Unable to submit request because Please use google_search field instead of google_search_retrieval field.. Learn more: https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/gemini', 'status': 'INVALID_ARGUMENT'}}

DynamicRetrievalConfig is a config within GoogleSearchRetrieval, GoogleSearch doesn't have this setting. So you can use DynamicRetrievalConfig in a 1.5 model, e.g.

response = client.models.generate_content(
    model='gemini-1.5-flash',
    contents="Who won Wimbledon this year?",
    config=types.GenerateContentConfig(
        tools=[types.Tool(
            google_search_retrieval=types.GoogleSearchRetrieval(
                dynamic_retrieval_config=types.DynamicRetrievalConfig(
                    dynamic_threshold=0.6))
        )]
    )
)