Saltearse al contenido
Nappai Documentation

Web Search (SearXng)

Web Search (SearXng) es un componente sencillo que te permite realizar búsquedas en la web directamente desde tu dashboard de Nappai. Se conecta a tu instancia SearXNG para obtener resultados de búsqueda y te devuelve una lista de enlaces y títulos que puedes usar en cualquier parte de tu flujo de trabajo.

¿Cómo funciona?

El componente envía la consulta que introduces a la API de SearXNG (el motor de búsqueda privado de Nappai). La instancia SearXNG procesa la solicitud y devuelve una lista de resultados en formato JSON. Cada resultado contiene un título y una URL. El componente recibe estos datos, los convierte en objetos Data y también crea una herramienta Tool que puede ser usada por agentes de Langchain para ejecutar búsquedas dinámicamente durante la conversación.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode”. 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 ser utilizado en cualquier operación (el componente no tiene operaciones distintas).

  • Search Query: Es el término que deseas buscar en la web. Puedes escribirlo directamente o mapearlo desde otro componente.

  • Mapping Mode: Interruptor que habilita el Modo de Mapeo. Cuando está activado, aparece la entrada “Mapping Data” que permite procesar varios registros en lote.

  • Max Results: Número máximo de resultados que quieres recibir. Este campo es obligatorio y controla cuántos enlaces se devuelven de la búsqueda.

  • Tool Description: Descripción que el agente de Langchain usará para entender el propósito de la herramienta.
    Ejemplo de valor por defecto

    'Search for recent results using Nappai SearXng search engine.';

  • Tool Name: Nombre que tendrá la herramienta creada por el componente. Este nombre es el que el agente utilizará cuando llame a la búsqueda.

Salidas

  • Data: Devuelve una lista de objetos Data con los resultados de la búsqueda. Cada objeto contiene el título y la URL del resultado, listo para ser procesado o mostrado.

  • Tool: Devuelve una herramienta Tool de Langchain que permite a agentes de IA ejecutar búsquedas en tiempo real durante sus conversaciones.

Ejemplo de Uso

  1. Configura el componente

    • En el campo Search Query escribe: "Python programming"
    • En Max Results pon 5.
    • Deja el Tool Description con el valor por defecto.
    • En Tool Name escribe PythonSearch.

  2. Activa Mapping Mode (si quieres procesar una lista de términos)

    • Conecta la entrada “Mapping Data” a la salida de un componente que genere una lista de consultas (por ejemplo, un bloque que reciba un CSV).

  3. Conecta las salidas

    • Conecta la salida Data a un bloque de visualización (por ejemplo, TextInput o ParseData).
    • Conecta la salida Tool a un agente LanggraphReactAgent para que el agente pueda llamar a la búsqueda cuando lo necesite.

  4. Ejecuta el flujo y observa los resultados de búsqueda en la salida Data y la herramienta disponible en Tool.

Componentes Relacionados

  • LanggraphReactAgent – Permite que un agente utilice la herramienta Tool creada por este componente para realizar búsquedas en tiempo real.
  • ParseData – Puede usarse para transformar la lista de resultados Data en un formato más adecuado para visualización o análisis.
  • TextInput – Puedes mostrar los títulos y URLs directamente en un bloque de texto dentro del dashboard.

Consejos y Mejores Prácticas

  • Define un Tool Name descriptivo para que los agentes lo reconozcan fácilmente.
  • Si necesitas ejecutar búsquedas en lote, activa el Modo de Mapeo y conecta la salida de un bloque que genere una lista de términos.
  • Limita Max Results a un número razonable (por ejemplo, 10) para evitar respuestas demasiado largas y mejorar la velocidad.

Consideraciones de Seguridad

  • Evita enviar datos sensibles en las consultas, ya que se registran en la instancia SearXNG y pueden ser accesibles externamente.
  • Si tu instancia SearXNG está expuesta públicamente, monitorea los logs y aplica medidas de autenticación o límites de tasa para protegerla.