Visión general
La búsqueda en la web le da al bot dos herramientas para consultar la internet pública — cosas que no sabe y que no están en tu cuenta: noticias, precios de mercado, datos públicos de empresas, documentación, cualquier cosa que cambió después del entrenamiento del modelo.
| Herramienta | Qué hace |
|---|---|
web_search |
Busca en la web y devuelve resultados rankeados con título, URL y un fragmento de cada página. |
web_fetch |
Lee el texto completo de páginas específicas por URL — tras una búsqueda cuando el fragmento no alcanza, o cuando el bot ya tiene la URL. |
Ambas son de solo lectura y no envían nada al contacto: devuelven texto al modelo, que después decide qué (y si) va a decir. Por eso siguen disponibles cuando el bot delega en un subagente.
Para el contenido de tu cuenta — contactos, negocios, catálogo, historial — el bot tiene herramientas propias, y la base de conocimiento guarda tu material. La búsqueda en la web es para lo que está afuera.
Requisitos previos
- Maestro habilitado y un bot configurado.
- Una clave de API de Tavily disponible para el bot (ver «La clave» más abajo).
- Las herramientas
web_searchy/oweb_fetchhabilitadas en la grilla de herramientas del bot — sin ellas, nada de esta sección tiene efecto.
Paso a paso
- En la configuración del bot, abre la grilla de Herramientas y habilita Buscar en la web y/o Leer una página web (categoría Conocimiento).
- Baja hasta la sección Búsqueda en la web. Si ninguna de las dos está activa, un aviso te informa que nada de allí tendrá efecto todavía.
- Ajusta Profundidad de la búsqueda y Resultados por búsqueda.
- Si quieres restringir, completa Buscar solo en estos dominios y/o Nunca en estos dominios.
- Guarda.
Para apagar la búsqueda por completo, deshabilita las dos herramientas en la grilla. Tu configuración queda guardada para cuando vuelvas a activarlas.
Configuración y opciones
| Opción | Qué hace | Predeterminado |
|---|---|---|
| Profundidad de la búsqueda | Básica o Avanzada. La avanzada lee más de cada página y acierta más, pero consume más créditos por llamada. También se aplica cuando web_fetch lee una página. |
Básica |
| Resultados por búsqueda | Tope de 1 a 20. Vacío = el predeterminado de la herramienta (5). | Vacío (5) |
| Buscar solo en estos dominios | Restringe la búsqueda a esos dominios. Vacío = toda la web. | Vacío |
| Nunca en estos dominios | Bloquea siempre esos dominios. | Vacío |
Cómo se combinan las dos listas de dominios
No funcionan igual, y la diferencia es deliberada:
- Buscar solo en estos dominios es una restricción. Cuando la completas, la lista propia del bot se ignora — no puede buscar en otro lugar, ni aunque lo pida. Una restricción que el modelo puede ampliar no es una restricción.
- Nunca en estos dominios es una lista de bloqueo. Tus dominios valen siempre, y el bot todavía puede agregar otros para una consulta puntual.
Escribe los dominios separados por comas o saltos de línea. https://, www. y la ruta después de
la barra se quitan automáticamente — Tavily compara hosts, así que https://ejemplo.com/precios
se convierte en ejemplo.com.
Qué decide el bot (y tú no)
- Cuántos resultados pedir en esa consulta: puede pedir menos que tu tope, nunca más.
- El tema de la consulta (general, noticias o finanzas) y la ventana de tiempo (último día, semana, mes o año), decididos por pregunta. Hoy ninguno tiene campo fijo por bot — el predeterminado es general, sin recorte de tiempo.
- Qué URLs leer con
web_fetch— como máximo 5 por llamada.
La clave (Tavily)
La búsqueda necesita una clave de Tavily. Se busca en este orden:
- La clave del propio bot (sección de claves de API, proveedor tavily).
- La clave de tu cuenta, en Integraciones.
- La clave de la instalación, configurada por el operador.
Sin ninguna de ellas, las herramientas responden que la búsqueda no está configurada y el bot sigue la conversación con lo que ya sabe — la conversación no se rompe.
Casos de uso
- Soporte técnico — consultar la documentación pública de un socio antes de orientar al cliente.
- Preventa — revisar datos públicos de la empresa del contacto para calificar mejor.
- Noticias y precios — responder sobre algo que cambió después del entrenamiento del modelo.
- Base restringida — pon tu propio sitio y tu documentación en Buscar solo en estos dominios: el bot busca solo allí, como una búsqueda interna sobre contenido público.
Consejos, límites y buenas prácticas
- Cada búsqueda consume créditos de Tavily. La profundidad avanzada y un número alto de resultados multiplican el gasto — empieza en Básica con el predeterminado de 5.
- Un resultado de más también es contexto de más en el turno: 20 resultados pueden empujar hacia afuera información de la propia conversación.
web_fetchlee como máximo 5 páginas por llamada, y el texto de cada página se trunca para caber en el turno.- Una URL que no se pudo leer se informa al bot, no se descarta en silencio — así no responde como si la hubiera revisado.
- La web pública no es fuente de verdad sobre tu operación. Para tus precios, políticas y plazos, usa la base de conocimiento.
- Combínala con la verificación de turno si quieres retener respuestas que afirmen algo que el turno no comprobó.
Solución de problemas
- «Configuré todo y el bot nunca busca» — ¿están habilitadas las herramientas
web_search/web_fetchen la grilla? El aviso de la sección te avisa cuando no lo están. - «La búsqueda no está configurada» — no hay clave de Tavily en ninguno de los tres niveles.
- «La clave de API es inválida» — la clave existe pero fue rechazada; genera otra en Tavily.
- «Se alcanzó el límite del plan» — la cuenta de Tavily se quedó sin créditos.
- «La búsqueda está limitada ahora» — demasiadas llamadas en poco tiempo; reintenta después.
- «Buscó en un sitio que yo no quería» — agrega el dominio a Nunca en estos dominios, o restringe todo con Buscar solo en estos dominios.
- «Los resultados vienen de otro país/idioma» — haz la consulta más específica en las instrucciones del bot y restringe por dominio.