Web Search (SearXng)

Web Search (SearXng) es un componente que permite a los usuarios buscar información en la web directamente desde el dashboard de Nappai. Con él, puedes enviar una consulta, recibir los resultados más relevantes y generar una herramienta de búsqueda personalizada que otros componentes pueden usar.

¿Cómo funciona?

El componente envía la consulta de búsqueda a la instancia de SearXNG que corre dentro de Nappai. SearXNG recopila resultados de varios motores de búsqueda abiertos y devuelve una lista de enlaces y fragmentos de contenido. El componente procesa estos resultados y los entrega en dos formas:

Data – Una lista de objetos Data que contienen el texto de cada resultado, su metadata y los enlaces encontrados en la página.
Tool – Una herramienta estructurada que puede ser llamada por otros componentes o por el modelo de IA para ejecutar búsquedas dinámicas durante el flujo de trabajo.

No se necesita ninguna configuración externa; el componente se comunica con la instancia local de SearXNG mediante una llamada HTTP interna.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

Fixed (Fijo): Escribes el valor directamente en el campo.
Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Search Query: La frase o palabras clave que quieres buscar en la web.
Mapping Mode: Interruptor que habilita el modo de mapeo para procesar varios registros a la vez.
Max Results: Número máximo de resultados que quieres recibir. Este valor es obligatorio.
Tool Description: Texto que describe la herramienta que se generará. Se usa para que el modelo de IA entienda qué hacer cuando invoque la herramienta.
Ejemplo por defecto:
```
Search for recent results using Nappai SearXng search engine.
```
Tool Name: Nombre que tendrá la herramienta generada. Este nombre se mostrará cuando la herramienta sea llamada por el modelo.

Salidas

Data: Una colección de objetos Data que contienen el contenido de cada resultado de búsqueda, su metadata y los enlaces encontrados en la página. Puedes usar esta salida para mostrar los resultados al usuario o para procesarlos en pasos posteriores.
Tool: Una herramienta estructurada que puede ser invocada por el modelo de IA o por otros componentes. Permite ejecutar búsquedas dinámicas dentro del flujo de trabajo sin volver a configurar el componente.

Ejemplo de Uso

Imagina que quieres crear un flujo que busque información sobre “últimas tendencias en IA” y que el modelo de IA pueda usar esa búsqueda en tiempo real.

Configura el componente
- Search Query: últimas tendencias en IA
- Max Results: 5
- Tool Description: Search for recent results using Nappai SearXng search engine.
- Tool Name: AI Trends Search
Conecta la salida Data a un bloque de visualización para mostrar los resultados al usuario.
Conecta la salida Tool a un bloque de “LLM” o “Chat” para que el modelo pueda llamar a la herramienta cuando necesite información actualizada.

El flujo completo permite que el usuario vea los resultados de búsqueda y que el modelo de IA los consulte cuando sea necesario, todo sin salir del dashboard.

Componentes Relacionados

SearXngBase – La clase base que gestiona la comunicación con la instancia de SearXNG.
Firecrawl Web Crawler – Si necesitas extraer contenido de páginas web más a fondo, este componente complementa la búsqueda básica.
Nappai Base Component – La capa común que facilita la integración de componentes en el flujo de trabajo de Nappai.

Consejos y Mejores Prácticas

Limita el número de resultados: Un valor alto puede ralentizar el flujo y generar demasiada información no deseada.
Usa un Tool Description claro: Un buen texto ayuda al modelo a entender cuándo y cómo usar la herramienta.
Activa Mapping Mode solo cuando necesites procesar lotes: Si solo buscas un resultado, el modo fijo es más sencillo.
Revisa la metadata: Los enlaces y la información de origen pueden ser útiles para validar la fiabilidad de los resultados.

Consideraciones de Seguridad

Los resultados de búsqueda pueden incluir contenido no verificado o potencialmente ofensivo.
Si el flujo se comparte con usuarios externos, considera filtrar o moderar los resultados antes de mostrarlos.
La herramienta generada no tiene restricciones de acceso; asegúrate de que solo usuarios autorizados puedan invocarla si la información es sensible.