## 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_search`** y/o **`web_fetch`** habilitadas en la grilla de herramientas del
  bot — sin ellas, nada de esta sección tiene efecto.

## Paso a paso

1. 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**).
2. 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.
3. Ajusta **Profundidad de la búsqueda** y **Resultados por búsqueda**.
4. Si quieres restringir, completa **Buscar solo en estos dominios** y/o **Nunca en estos dominios**.
5. **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:

1. La clave **del propio bot** (sección de claves de API, proveedor **tavily**).
2. La clave **de tu cuenta**, en Integraciones.
3. 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_fetch` lee 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_fetch`** en 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.

## Ver también

- [Qué son Maestro IA y el Cerebro de la Cuenta](/hc/ajuda/articles/maestro-brain-overview-es)
- [Herramientas de Maestro por módulo](/hc/ajuda/articles/maestro-brain-ferramentas-maestro-por-modulo-es)
- [Base de conocimiento y ontología](/hc/ajuda/articles/maestro-brain-base-de-conhecimento-e-ontologia-es)
- [Verificación de lo que el bot afirma](/hc/ajuda/articles/maestro-brain-verificacao-do-que-o-robo-afirma-es)