# Copyright 2025 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. from __future__ import annotations from typing import TYPE_CHECKING from google.genai import types from typing_extensions import override from .base_tool import BaseTool from .tool_context import ToolContext if TYPE_CHECKING: from ..models import LlmRequest class GoogleSearchTool(BaseTool): """A built-in tool that is automatically invoked by Gemini 2 models to retrieve search results from Google Search. This tool operates internally within the model and does not require or perform local code execution. """ def __init__(self): # Name and description are not used because this is a model built-in tool. super().__init__(name='google_search', description='google_search') @override async def process_llm_request( self, *, tool_context: ToolContext, llm_request: LlmRequest, ) -> None: llm_request.config = llm_request.config or types.GenerateContentConfig() llm_request.config.tools = llm_request.config.tools or [] if llm_request.model and llm_request.model.startswith('gemini-1'): if llm_request.config.tools: print(llm_request.config.tools) raise ValueError( 'Google search tool can not be used with other tools in Gemini 1.x.' ) llm_request.config.tools.append( types.Tool(google_search_retrieval=types.GoogleSearchRetrieval()) ) elif llm_request.model and llm_request.model.startswith('gemini-2'): llm_request.config.tools.append( types.Tool(google_search=types.GoogleSearch()) ) else: raise ValueError( f'Google search tool is not supported for model {llm_request.model}' ) google_search = GoogleSearchTool()