Tool de búsqueda web

La plantilla web_search da a un agente (o a una inferencia) búsqueda en internet: el modelo la llama con una consulta y recibe lo que se encontró, con las direcciones de las fuentes. Sirve para lo que el modelo no puede saber de memoria: noticias, precios, horarios, eventos o cualquier dato que cambie.

Funciona con cualquier modelo de agente. La búsqueda no la hace el modelo del agente, sino el proveedor que elijas en la instancia. Por eso un agente que corre en Mistral (o en un modelo propio) puede buscar con el buscador de Anthropic o con el de Google.

Se configura en Tools → Nueva instancia → Web search. Además de la identidad, tiene una sección, Búsqueda.

Solo un administrador la engancha

La búsqueda se hace con la clave del proveedor y cada búsqueda se paga aparte. Por eso un usuario que no es administrador no puede añadir una instancia web_search a sus agentes o inferencias: en el formulario sale deshabilitada, con el motivo. Si un administrador ya se la había enganchado, se conserva aunque ese usuario edite el resto.

Con qué se busca

Se elige un proveedor, no un modelo:

Proveedor	Cómo busca	Coste de la búsqueda	Filtro de dominios
Anthropic	Claude Haiku con la búsqueda web de Anthropic. Puede encadenar varias búsquedas, hasta el máximo que pongas, y resume lo que encuentra citando las fuentes.	10 $ por cada 1000 búsquedas, más los tokens.	Unos dominios o excluir otros, no las dos cosas a la vez.
Google	Gemini Flash-Lite con Google Search.	5000 búsquedas al mes gratis; después, 14 $ por cada 1000, más los tokens.	No.
OpenAI	GPT-4o mini con la búsqueda web de OpenAI.	10 $ por cada 1000 búsquedas, más un bloque fijo de 8000 tokens de entrada por búsqueda.	Solo limitar a unos dominios.
Tavily	Un buscador pensado para agentes. No resume: el modelo del agente lee directamente los extractos de las páginas.	1000 búsquedas al mes gratis; después, 0,008 $ cada una (el doble en profundidad avanzada).	Unos dominios, excluir otros, o las dos cosas.

Los precios son los que publicaban los proveedores en octubre de 2026; los tokens se cobran a la tarifa de cada modelo. Los resultados de la búsqueda cuentan como tokens de entrada dos veces: primero en la llamada del modelo de búsqueda y después en la del agente, que lee el resumen.

La clave. Con Anthropic, Google u OpenAI la búsqueda usa la clave por defecto de ese proveedor en Proveedores: la primera que se dio de alta. Da igual el modelo con el que corra el agente. Cada tarjeta del formulario dice si el proveedor tiene clave. Si no la tiene, la tool contesta que la búsqueda no está disponible hasta que la tenga. La clave de Tavily es de la instancia: se guarda cifrada y no vuelve a mostrarse. Al editar, se deja vacía para conservarla.

Opciones

Campo	Para qué
Búsquedas por llamada (solo Anthropic)	Cuántas búsquedas puede encadenar Claude para contestar una llamada a la tool. Cada una se cobra. Una pregunta sencilla suele necesitar una o dos.
Instrucciones de búsqueda (Anthropic, Google y OpenAI)	Lo que se le pide al modelo que busca: datos concretos, sin opiniones, en el idioma de la consulta. Heredan las de Ajustes del sistema → Prompts, o la instancia tiene las suyas; por ejemplo, para pedirle que cite siempre la fuente oficial. Debajo, ur le añade la fecha de hoy. Tavily no tiene modelo que las lea.
Solo en estos dominios / Nunca en estos dominios	Uno por línea, sin https:// (tusitio.com, tusitio.com/blog). Sirven, por ejemplo, para un agente que solo debe buscar en la web de la empresa. Solo aparecen los que admite el proveedor elegido. Al cambiar de proveedor, se vacían los que el nuevo no admite.
Profundidad, Tipo y Resultados (solo Tavily)	La profundidad avanzada saca extractos más relevantes, a cambio de tardar más y gastar el doble. El tipo Noticias prioriza lo reciente.
Plazo	Lo que se espera a la búsqueda entera, varias búsquedas encadenadas incluidas (60 s por defecto). Al vencer, el agente lee que la búsqueda no está disponible.
Máximo de caracteres	Lo que lee el modelo del agente como mucho. Lo que pase se recorta, con una nota que lo dice.

Qué recibe el agente

Con Anthropic, Google y OpenAI, el agente recibe un resumen factual de lo que se encontró, en el idioma de la consulta, seguido de la lista Sources con el título y la dirección de cada página. Primero van las que respaldan el resumen, hasta diez. Con Tavily recibe una lista numerada de resultados con su extracto.

Todo llega dentro de un bloque <untrusted_document>, y la descripción de la tool le dice al modelo que lo que hay dentro es contenido de la web y no instrucciones. Así, una página que diga «ignora tus instrucciones» no se trata como una orden.

Para el resto del sistema es una tool como cualquier otra. Aparece como chip en Probar agente y en las conversaciones, cuenta para el máximo de tools por turno y sale en el toolCalls de la API. Con Probar tool se lanza una búsqueda con la configuración guardada y se ve lo que recibiría el modelo. Debajo salen las consultas que hizo el proveedor, cuántas búsquedas fueron, los tokens del modelo de búsqueda y las fuentes.

Qué parte del gasto se ve en el panel

Una búsqueda cuesta dos cosas: lo que cobra el proveedor por cada búsqueda y los tokens del modelo que busca y resume. El panel solo cuenta tokens, y no en todas las pantallas:

Pantalla	Tokens del modelo de búsqueda	Lo que se cobra por búsqueda
Probar tool	En el detalle de la respuesta (inputTokens, outputTokens), junto al número de búsquedas.	No
Probar inferencia	Sumados al uso y al coste de la respuesta.	No
Probar agente, mientras se conversa	No: el uso de cada respuesta y el total que va sumando solo cuentan el modelo del agente.	No
Probar agente al reabrir la conversación, y la vista de conversaciones	Sumados al total de la conversación, al precio del modelo de búsqueda. El uso de cada mensaje no los incluye.	No

Lo que cobra el proveedor por cada búsqueda solo se ve en su consola. El número de búsquedas de cada llamada sí está en el detalle de Probar tool.

A tener en cuenta

• Los enlaces de Google pasan por una redirección suya (vertexaisearch.cloud.google.com/…), y el título de la fuente suele ser solo el dominio.
• Condiciones de Google. Las condiciones de Grounding with Google Search piden mostrar sus sugerencias de búsqueda al usuario final cuando ve resultados con grounding. Antes de usar Google en un widget público, revisa si te aplica. Si tienes dudas, usa Anthropic o Tavily.