Saltearse al contenido
Nappai Documentation

Gemini Built-in tools

Gemini Built-in tools te da acceso a las herramientas que Google Gemini trae incorporadas: buscar en Google, hacer cálculos y análisis, leer el contenido de páginas web y consultar Google Maps. Escribes una petición, Gemini usa la herramienta elegida y te devuelve la respuesta redactada, con los enlaces de las fuentes cuando las hay.

Puedes usarlo como paso de un flujo, con la petición en Input or instruction, o como herramienta de un agente: conectas su salida Tool al conector Tools del agente y el agente lo usa cuando necesita buscar en Google, calcular o consultar un mapa.

Cuándo usarlo

  • Un agente necesita responder con información actual de internet y citar de dónde sale.
  • Quieres limitar las fuentes a webs oficiales, por ejemplo boletines o webs de la administración.
  • Un asistente de reservas tiene que recomendar restaurantes o calcular rutas con Google Maps.
  • Quieres resumir o comparar el contenido de varias páginas web a partir de sus direcciones.
  • Necesitas cálculos o análisis de datos precisos dentro de una respuesta.

Configuración

Necesitas una credencial Google Gemini con la clave de tu cuenta de Google AI Studio. Consulta Credenciales.

CampoQué hace
Built-in toolLas herramientas de Gemini que se usan. Puedes marcar varias: google_search (buscar en Google), code_execution (hacer cálculos y análisis), url_context (leer las páginas web cuyas direcciones incluyas en la petición) y google_maps (lugares, rutas y datos de negocios). Por defecto, google_search.
Input or instructionLa pregunta o la petición, por ejemplo Novedades fiscales para autónomos publicadas este mes.
ModelEl modelo de Gemini que responde. La lista muestra los modelos de tu cuenta de Google.
Google API KeyLa clave de tu cuenta de Google Gemini.

Opciones avanzadas

CampoQué hace
System PromptInstrucciones generales para el modelo, por ejemplo el tono o el formato de la respuesta.
User PromptPlantilla de la petición. {input_query} se sustituye por el texto de Input or instruction. Por defecto, solo {input_query}.
TemperatureCuánta variedad tienen las respuestas: valores bajos dan respuestas más previsibles. Por defecto, 1.
Max Output TokensLongitud máxima de la respuesta. Por defecto, 4096.
Top P y Top KAjustes finos de cómo elige las palabras el modelo. Déjalos vacíos salvo que sepas que los necesitas.
Latitude y LongitudeSolo con google_maps. La ubicación desde la que se hace la consulta, para preguntas como “restaurantes cerca de aquí”.
Enable Maps WidgetSolo con google_maps. Añade al resultado los datos para mostrar el mapa interactivo de Google en tu propia web. Desactivado por defecto.
Enable Inline CitationsSi está activado, la respuesta incluye enlaces numerados a las fuentes, como [1](enlace), junto a cada afirmación. Activado por defecto.
Allowed Source DomainsDominios aceptados como fuentes, separados por comas, por ejemplo boe.es,agenciatributaria.gob.es. Las fuentes de otros dominios se descartan. Vacío, se aceptan todos.
Blocked Source DomainsDominios que nunca se aceptan como fuentes, separados por comas.
Enable Search CacheSi está activado, las búsquedas en Google equivalentes a otras recientes reutilizan la respuesta anterior, lo que ahorra tiempo y consumo. Activado por defecto.
Cache TTL (hours)Durante cuántas horas se reutiliza una respuesta guardada. Por defecto, 24.

Resultado

  • Data: la respuesta de Gemini, con las citas si están activadas. Según la herramienta usada, incluye también la lista de fuentes con sus enlaces, las búsquedas que hizo en Google o el cálculo realizado y su resultado.
  • Tool: las herramientas listas para un agente. El agente recibe una herramienta por cada opción marcada en Built-in tool entre google_search, code_execution y google_maps. Usa url_context como paso del flujo, no como herramienta de un agente. Conéctala al conector Tools del agente.

Ejemplo

Una asesoría quiere un asistente que responda dudas fiscales solo con fuentes oficiales.

  1. Añade Gemini Built-in tools con google_search marcado y elige la credencial Google Gemini de la asesoría.
  2. En Allowed Source Domains, escribe boe.es,agenciatributaria.gob.es.
  3. Conecta la salida Tool al conector Tools del agente.
  4. Cuando un cliente pregunta por el plazo de una declaración, el agente busca, responde y enlaza la página oficial de donde sale el dato.

Buenas prácticas

  • Para un agente, marca solo las herramientas que de verdad necesita: así elige mejor cuál usar.
  • Si cambias las fuentes permitidas o necesitas datos al minuto, ten en cuenta que la caché puede devolver una respuesta de hasta Cache TTL (hours) horas. Desactiva Enable Search Cache si necesitas siempre resultados nuevos.

Componentes relacionados