IMPORTANT: In July 2025, we stopped releasing new versions of KTX modules, and we removed the KTX libraries from the Firebase Android BoM (v34.0.0). If you use KTX APIs from the previously released KTX modules, we recommend that you migrate your app to use KTX APIs from the main modules instead. For details, see the FAQ about this initiative.

Tool

class Tool

Contains a set of tools (like function declarations) that the model has access to. These tools can be used to gather information or complete tasks.

Summary

Public companion functions
`Tool`	`codeExecution()` Creates a `Tool` instance that allows the model to use code execution.
`Tool`	`functionDeclarations(functionDeclarations: List<FunctionDeclaration>)` Creates a `Tool` instance that provides the model with access to the `functionDeclarations`.
`Tool`	`googleSearch(googleSearch: GoogleSearch)` Creates a `Tool` instance that allows the model to use grounding with Google Search.
`Tool`	`@PublicPreviewAPI urlContext(urlContext: UrlContext)` Creates a `Tool` instance that allows you to provide additional context to the models in the form of public web URLs.

Public companion functions

codeExecution

fun codeExecution(): Tool

Creates a Tool instance that allows the model to use code execution.

functionDeclarations

fun functionDeclarations(functionDeclarations: List<FunctionDeclaration>): Tool

Creates a Tool instance that provides the model with access to the functionDeclarations.

Parameters
`functionDeclarations: List<FunctionDeclaration>`	The list of functions that this tool allows the model access to.

googleSearch

fun googleSearch(googleSearch: GoogleSearch = GoogleSearch()): Tool

Creates a Tool instance that allows the model to use grounding with Google Search.

Grounding with Google Search can be used to allow the model to connect to Google Search to access and incorporate up-to-date information from the web into it's responses.

When using this feature, you are required to comply with the "grounding with Google Search" usage requirements for your chosen API provider: Gemini Developer API or Vertex AI Gemini API (see Service Terms section within the Service Specific Terms).

Parameters
`googleSearch: GoogleSearch = GoogleSearch()`	An empty `GoogleSearch` object. The presence of this object in the list of tools enables the model to use Google Search.

Returns
`Tool`	A `Tool` configured for Google Search.

urlContext

@PublicPreviewAPI
fun urlContext(urlContext: UrlContext = UrlContext()): Tool

Creates a Tool instance that allows you to provide additional context to the models in the form of public web URLs. By including URLs in your request, the Gemini model will access the content from those pages to inform and enhance its response.

Parameters
`urlContext: UrlContext = UrlContext()`	Specifies the URL context configuration.

Returns
`Tool`	A `Tool` configured for URL context.