Skip to content
Nappai Documentation

Gemini Built-in tools

Gemini Built-in tools gives you access to the tools Google Gemini has built in: searching Google, running calculations and analyses, reading the content of web pages and querying Google Maps. You write a request, Gemini uses the chosen tool and returns a written answer, with links to the sources when there are any.

You can use it as a step in a flow, with the request in Input or instruction, or as a tool for an agent: connect its Tool output to the agent’s Tools input and the agent uses it when it needs to search Google, calculate or check a map.

When to use it

  • An agent needs to answer with current information from the internet and say where it comes from.
  • You want to limit sources to official websites, such as official gazettes or government sites.
  • A booking assistant has to recommend restaurants or work out routes with Google Maps.
  • You want to summarise or compare the content of several web pages from their addresses.
  • You need precise calculations or data analysis inside an answer.

Configuration

You need a Google Gemini credential with your Google AI Studio key. See Credentials.

FieldWhat it does
Built-in toolThe Gemini tools to use. You can tick several: google_search (search Google), code_execution (calculations and analyses), url_context (read the web pages whose addresses you include in the request) and google_maps (places, routes and business details). Default: google_search.
Input or instructionThe question or request, for example Tax changes for freelancers published this month.
ModelThe Gemini model that answers. The list shows the models in your Google account.
Google API KeyYour Google Gemini account key.

Advanced options

FieldWhat it does
System PromptGeneral instructions for the model, such as the tone or format of the answer.
User PromptThe request template. {input_query} is replaced by the text in Input or instruction. Default: just {input_query}.
TemperatureHow varied the answers are: low values give more predictable answers. Default: 1.
Max Output TokensThe maximum length of the answer. Default: 4096.
Top P and Top KFine-tuning of how the model picks words. Leave them empty unless you know you need them.
Latitude and LongitudeOnly with google_maps. The location the query is made from, for questions like “restaurants near here”.
Enable Maps WidgetOnly with google_maps. Adds to the result what you need to show Google’s interactive map on your own website. Off by default.
Enable Inline CitationsWhen on, the answer includes numbered links to the sources, like [1](link), next to each statement. On by default.
Allowed Source DomainsDomains accepted as sources, separated by commas, for example gov.uk,hmrc.gov.uk. Sources from other domains are discarded. When empty, all are accepted.
Blocked Source DomainsDomains never accepted as sources, separated by commas.
Enable Search CacheWhen on, Google searches equivalent to recent ones reuse the earlier answer, which saves time and usage. On by default.
Cache TTL (hours)How many hours a saved answer is reused for. Default: 24.

Output

  • Data: Gemini’s answer, with citations if they are on. Depending on the tool used, it also includes the list of sources with their links, the Google searches it ran, or the calculation and its result.
  • Tool: the tools ready for an agent. The agent gets one tool for each option ticked in Built-in tool among google_search, code_execution and google_maps. Use url_context as a flow step, not as an agent tool. Connect it to the agent’s Tools input.

Example

A tax advisory firm wants an assistant that answers tax questions using official sources only.

  1. Add Gemini Built-in tools with google_search ticked and choose the firm’s Google Gemini credential.
  2. In Allowed Source Domains, type gov.uk,hmrc.gov.uk.
  3. Connect the Tool output to the agent’s Tools input.
  4. When a client asks about a filing deadline, the agent searches, answers and links the official page the information comes from.

Good practices

  • For an agent, tick only the tools it really needs: that way it chooses better which one to use.
  • If you change the allowed sources or need up-to-the-minute data, bear in mind the cache can return an answer up to Cache TTL (hours) hours old. Turn off Enable Search Cache if you always need fresh results.