Package com.google.genai.types

Class Tool.Builder

java.lang.Object
com.google.genai.types.Tool.Builder
Enclosing class:
Tool
public abstract static class Tool.Builder extends Object
Builder for Tool.

  • Constructor Details

    • Builder

      public Builder()

  • Method Details

    • retrieval

      public abstract Tool.Builder retrieval(Retrieval retrieval)
      Setter for retrieval.

      retrieval: Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. This field is not supported in Gemini API.

    • retrieval

      @CanIgnoreReturnValue public Tool.Builder retrieval(Retrieval.Builder retrievalBuilder)
      Setter for retrieval builder.

      retrieval: Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. This field is not supported in Gemini API.

    • clearRetrieval

      @CanIgnoreReturnValue public Tool.Builder clearRetrieval()
      Clears the value of retrieval field.

    • functions

      public abstract Tool.Builder functions(List<Method> functions)
      Setter for functions.

      functions: The java.lang.reflect.Method instance. If provided, it will to be parsed into a list of FunctionDeclaration instances, and be assigned to the functionDeclarations field.

    • functions

      @CanIgnoreReturnValue public Tool.Builder functions(Method... functions)
      Setter for functions.

      functions: The java.lang.reflect.Method instance. If provided, it will to be parsed into a list of FunctionDeclaration instances, and be assigned to the functionDeclarations field.

    • clearFunctions

      @CanIgnoreReturnValue public Tool.Builder clearFunctions()
      Clears the value of functions field.

    • computerUse

      public abstract Tool.Builder computerUse(ComputerUse computerUse)
      Setter for computerUse.

      computerUse: Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations.

    • computerUse

      @CanIgnoreReturnValue public Tool.Builder computerUse(ComputerUse.Builder computerUseBuilder)
      Setter for computerUse builder.

      computerUse: Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations.

    • clearComputerUse

      @CanIgnoreReturnValue public Tool.Builder clearComputerUse()
      Clears the value of computerUse field.

    • fileSearch

      public abstract Tool.Builder fileSearch(FileSearch fileSearch)
      Setter for fileSearch.

      fileSearch: Optional. Tool to retrieve knowledge from the File Search Stores.

    • fileSearch

      @CanIgnoreReturnValue public Tool.Builder fileSearch(FileSearch.Builder fileSearchBuilder)
      Setter for fileSearch builder.

      fileSearch: Optional. Tool to retrieve knowledge from the File Search Stores.

    • clearFileSearch

      @CanIgnoreReturnValue public Tool.Builder clearFileSearch()
      Clears the value of fileSearch field.

    • googleSearch

      public abstract Tool.Builder googleSearch(GoogleSearch googleSearch)
      Setter for googleSearch.

      googleSearch: Enables the model to execute Google Search as part of generation.

    • googleSearch

      @CanIgnoreReturnValue public Tool.Builder googleSearch(GoogleSearch.Builder googleSearchBuilder)
      Setter for googleSearch builder.

      googleSearch: Enables the model to execute Google Search as part of generation.

    • clearGoogleSearch

      @CanIgnoreReturnValue public Tool.Builder clearGoogleSearch()
      Clears the value of googleSearch field.

    • googleMaps

      public abstract Tool.Builder googleMaps(GoogleMaps googleMaps)
      Setter for googleMaps.

      googleMaps: Optional. Tool that allows grounding the model's response with geospatial context related to the user's query.

    • googleMaps

      @CanIgnoreReturnValue public Tool.Builder googleMaps(GoogleMaps.Builder googleMapsBuilder)
      Setter for googleMaps builder.

      googleMaps: Optional. Tool that allows grounding the model's response with geospatial context related to the user's query.

    • clearGoogleMaps

      @CanIgnoreReturnValue public Tool.Builder clearGoogleMaps()
      Clears the value of googleMaps field.

    • codeExecution

      public abstract Tool.Builder codeExecution(ToolCodeExecution codeExecution)
      Setter for codeExecution.

      codeExecution: Optional. CodeExecution tool type. Enables the model to execute code as part of generation.

    • codeExecution

      @CanIgnoreReturnValue public Tool.Builder codeExecution(ToolCodeExecution.Builder codeExecutionBuilder)
      Setter for codeExecution builder.

      codeExecution: Optional. CodeExecution tool type. Enables the model to execute code as part of generation.

    • clearCodeExecution

      @CanIgnoreReturnValue public Tool.Builder clearCodeExecution()
      Clears the value of codeExecution field.

    • enterpriseWebSearch

      public abstract Tool.Builder enterpriseWebSearch(EnterpriseWebSearch enterpriseWebSearch)
      Setter for enterpriseWebSearch.

      enterpriseWebSearch: Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. This field is not supported in Gemini API.

    • enterpriseWebSearch

      @CanIgnoreReturnValue public Tool.Builder enterpriseWebSearch(EnterpriseWebSearch.Builder enterpriseWebSearchBuilder)
      Setter for enterpriseWebSearch builder.

      enterpriseWebSearch: Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. This field is not supported in Gemini API.

    • clearEnterpriseWebSearch

      @CanIgnoreReturnValue public Tool.Builder clearEnterpriseWebSearch()
      Clears the value of enterpriseWebSearch field.

    • functionDeclarations

      public abstract Tool.Builder functionDeclarations(List<FunctionDeclaration> functionDeclarations)
      Setter for functionDeclarations.

      functionDeclarations: Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided.

    • functionDeclarations

      @CanIgnoreReturnValue public Tool.Builder functionDeclarations(FunctionDeclaration... functionDeclarations)
      Setter for functionDeclarations.

      functionDeclarations: Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided.

    • functionDeclarations

      @CanIgnoreReturnValue public Tool.Builder functionDeclarations(FunctionDeclaration.Builder... functionDeclarationsBuilders)
      Setter for functionDeclarations builder.

      functionDeclarations: Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided.

    • clearFunctionDeclarations

      @CanIgnoreReturnValue public Tool.Builder clearFunctionDeclarations()
      Clears the value of functionDeclarations field.

    • googleSearchRetrieval

      public abstract Tool.Builder googleSearchRetrieval(GoogleSearchRetrieval googleSearchRetrieval)
      Setter for googleSearchRetrieval.

      googleSearchRetrieval: Optional. Specialized retrieval tool that is powered by Google Search.

    • googleSearchRetrieval

      @CanIgnoreReturnValue public Tool.Builder googleSearchRetrieval(GoogleSearchRetrieval.Builder googleSearchRetrievalBuilder)
      Setter for googleSearchRetrieval builder.

      googleSearchRetrieval: Optional. Specialized retrieval tool that is powered by Google Search.

    • clearGoogleSearchRetrieval

      @CanIgnoreReturnValue public Tool.Builder clearGoogleSearchRetrieval()
      Clears the value of googleSearchRetrieval field.

    • parallelAiSearch

      public abstract Tool.Builder parallelAiSearch(ToolParallelAiSearch parallelAiSearch)
      Setter for parallelAiSearch.

      parallelAiSearch: Optional. If specified, Vertex AI will use Parallel.ai to search for information to answer user queries. The search results will be grounded on Parallel.ai and presented to the model for response generation. This field is not supported in Gemini API.

    • parallelAiSearch

      @CanIgnoreReturnValue public Tool.Builder parallelAiSearch(ToolParallelAiSearch.Builder parallelAiSearchBuilder)
      Setter for parallelAiSearch builder.

      parallelAiSearch: Optional. If specified, Vertex AI will use Parallel.ai to search for information to answer user queries. The search results will be grounded on Parallel.ai and presented to the model for response generation. This field is not supported in Gemini API.

    • clearParallelAiSearch

      @CanIgnoreReturnValue public Tool.Builder clearParallelAiSearch()
      Clears the value of parallelAiSearch field.

    • urlContext

      public abstract Tool.Builder urlContext(UrlContext urlContext)
      Setter for urlContext.

      urlContext: Optional. Tool to support URL context retrieval.

    • urlContext

      @CanIgnoreReturnValue public Tool.Builder urlContext(UrlContext.Builder urlContextBuilder)
      Setter for urlContext builder.

      urlContext: Optional. Tool to support URL context retrieval.

    • clearUrlContext

      @CanIgnoreReturnValue public Tool.Builder clearUrlContext()
      Clears the value of urlContext field.

    • mcpServers

      public abstract Tool.Builder mcpServers(List<McpServer> mcpServers)
      Setter for mcpServers.

      mcpServers: Optional. MCP Servers to connect to. This field is not supported in Vertex AI.

    • mcpServers

      @CanIgnoreReturnValue public Tool.Builder mcpServers(McpServer... mcpServers)
      Setter for mcpServers.

      mcpServers: Optional. MCP Servers to connect to. This field is not supported in Vertex AI.

    • mcpServers

      @CanIgnoreReturnValue public Tool.Builder mcpServers(McpServer.Builder... mcpServersBuilders)
      Setter for mcpServers builder.

      mcpServers: Optional. MCP Servers to connect to. This field is not supported in Vertex AI.

    • clearMcpServers

      @CanIgnoreReturnValue public Tool.Builder clearMcpServers()
      Clears the value of mcpServers field.

    • build

      public abstract Tool build()