feat: Add new Gemini Deep Research agent models

PiperOrigin-RevId: 903258583

Author: Annhiluc

google/genai/_interactions/resources/interactions.py

@@ -210,7 +210,14 @@ def create(
         self,
         *,
         api_version: str | None = None,
-        agent: Union[str, Literal["deep-research-pro-preview-12-2025"]],
+        agent: Union[
+            Literal[
+                "deep-research-pro-preview-12-2025",
+                "deep-research-preview-04-2026",
+                "deep-research-max-preview-04-2026",
+            ],
+            str,
+        ],
         input: interaction_create_params.Input,
         agent_config: interaction_create_params.AgentConfig | Omit = omit,
         background: bool | Omit = omit,
@@ -280,7 +287,14 @@ def create(
         self,
         *,
         api_version: str | None = None,
-        agent: Union[str, Literal["deep-research-pro-preview-12-2025"]],
+        agent: Union[
+            Literal[
+                "deep-research-pro-preview-12-2025",
+                "deep-research-preview-04-2026",
+                "deep-research-max-preview-04-2026",
+            ],
+            str,
+        ],
         input: interaction_create_params.Input,
         stream: Literal[True],
         agent_config: interaction_create_params.AgentConfig | Omit = omit,
@@ -434,7 +448,15 @@ def create(
         system_instruction: str | Omit = omit,
         tools: Iterable[ToolParam] | Omit = omit,
         webhook_config: WebhookConfigParam | Omit = omit,
-        agent: Union[str, Literal["deep-research-pro-preview-12-2025"]] | Omit = omit,
+        agent: Union[
+            Literal[
+                "deep-research-pro-preview-12-2025",
+                "deep-research-preview-04-2026",
+                "deep-research-max-preview-04-2026",
+            ],
+            str,
+        ]
+        | Omit = omit,
         agent_config: interaction_create_params.AgentConfig | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -884,7 +906,14 @@ async def create(
         self,
         *,
         api_version: str | None = None,
-        agent: Union[str, Literal["deep-research-pro-preview-12-2025"]],
+        agent: Union[
+            Literal[
+                "deep-research-pro-preview-12-2025",
+                "deep-research-preview-04-2026",
+                "deep-research-max-preview-04-2026",
+            ],
+            str,
+        ],
         input: interaction_create_params.Input,
         agent_config: interaction_create_params.AgentConfig | Omit = omit,
         background: bool | Omit = omit,
@@ -954,7 +983,14 @@ async def create(
         self,
         *,
         api_version: str | None = None,
-        agent: Union[str, Literal["deep-research-pro-preview-12-2025"]],
+        agent: Union[
+            Literal[
+                "deep-research-pro-preview-12-2025",
+                "deep-research-preview-04-2026",
+                "deep-research-max-preview-04-2026",
+            ],
+            str,
+        ],
         input: interaction_create_params.Input,
         stream: Literal[True],
         agent_config: interaction_create_params.AgentConfig | Omit = omit,
@@ -1108,7 +1144,15 @@ async def create(
         system_instruction: str | Omit = omit,
         tools: Iterable[ToolParam] | Omit = omit,
         webhook_config: WebhookConfigParam | Omit = omit,
-        agent: Union[str, Literal["deep-research-pro-preview-12-2025"]] | Omit = omit,
+        agent: Union[
+            Literal[
+                "deep-research-pro-preview-12-2025",
+                "deep-research-preview-04-2026",
+                "deep-research-max-preview-04-2026",
+            ],
+            str,
+        ]
+        | Omit = omit,
         agent_config: interaction_create_params.AgentConfig | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.

google/genai/_interactions/types/interaction.py

@@ -106,7 +106,13 @@ class Interaction(BaseModel):
     (YYYY-MM-DDThh:mm:ssZ).
     """
 
-    agent: Union[str, Literal["deep-research-pro-preview-12-2025"], None] = None
+    agent: Union[
+        Literal[
+            "deep-research-pro-preview-12-2025", "deep-research-preview-04-2026", "deep-research-max-preview-04-2026"
+        ],
+        str,
+        None,
+    ] = None
     """The name of the `Agent` used for generating the interaction."""
 
     agent_config: Optional[AgentConfig] = None

google/genai/_interactions/types/interaction_create_params.py

@@ -141,7 +141,16 @@ class BaseCreateModelInteractionParams(TypedDict, total=False):
 class BaseCreateAgentInteractionParams(TypedDict, total=False):
     api_version: str
 
-    agent: Required[Union[str, Literal["deep-research-pro-preview-12-2025"]]]
+    agent: Required[
+        Union[
+            Literal[
+                "deep-research-pro-preview-12-2025",
+                "deep-research-preview-04-2026",
+                "deep-research-max-preview-04-2026",
+            ],
+            str,
+        ]
+    ]
     """The name of the `Agent` used for generating the interaction."""
 
     input: Required[Input]