Ollama Web Search

El componente Ollama Web Search permite a los usuarios buscar información en la web directamente desde el dashboard de Nappai. Al enviar una consulta, el componente hace una llamada a la API de búsqueda web de Ollama Cloud y devuelve los resultados más relevantes. Es ideal para integrar datos externos en flujos de trabajo automatizados sin salir de la plataforma.

¿Cómo funciona?

Cuando introduces una consulta de búsqueda, el componente envía una petición HTTP al endpoint de Ollama Cloud Web Search. La API devuelve una lista de resultados (hasta 10, según el parámetro Limit) que el componente entrega como un objeto de datos. Si el usuario activa el Mapping Mode, el componente puede procesar varias consultas a la vez, generando un resultado por cada registro de entrada.

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 consulta de búsqueda que quieres ejecutar. Puedes escribir una frase, una pregunta o cualquier término relevante.
Limit: El número de resultados que deseas recibir (entre 1 y 10). Este valor controla cuántos enlaces y fragmentos de texto se devuelven.
Mapping Mode: Interruptor que habilita el modo de mapeo para procesar múltiples registros en lote.
Tool Name: El nombre que aparecerá ante el agente cuando este componente se utilice como herramienta. Ayuda al agente a identificar la herramienta en sus decisiones.
Tool Description: Una descripción detallada de lo que hace la herramienta. Facilita al agente decidir cuándo usarla.
Tools arguments metadata: Metadatos que describen los argumentos que la herramienta acepta. Se utilizan para la generación automática de llamadas a la herramienta por parte del agente.

Credencial
Este componente necesita una credencial de tipo Ollama Cloud API.

Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada “Ollama Cloud API”.

Introduce tu Ollama Cloud API Key (puedes obtenerla en Ollama Cloud Console).

En el campo Credential del componente, selecciona la credencial que acabas de crear.

Nota: Los campos de la credencial (como la API Key) no aparecen en la lista de entradas de este componente.

Salidas

Data: Devuelve un objeto de datos que contiene los resultados de la búsqueda (títulos, URLs, fragmentos de texto, etc.). Este objeto se puede usar en pasos posteriores del flujo de trabajo para filtrar, analizar o mostrar la información.
Tool: Devuelve una representación de la herramienta que puede ser consumida por agentes de IA. Permite que el agente invoque la búsqueda directamente desde su lógica.

Ejemplo de Uso

Añade el componente “Ollama Web Search” al flujo de trabajo.
Configura la credencial siguiendo los pasos descritos en la sección de credenciales.
Introduce una consulta en el campo Search Query (por ejemplo, “últimas noticias sobre inteligencia artificial”).
Establece el límite en 5 para obtener los cinco resultados más relevantes.
Activa Mapping Mode si quieres procesar varias consultas a la vez (por ejemplo, una lista de temas).
Conecta la salida “Data” a un componente de visualización o a un paso de procesamiento de texto.
Ejecuta el flujo y observa cómo se muestran los resultados de la búsqueda en tiempo real.

Componentes Relacionados

Ollama Cloud Web Search Tool Component Base – La clase base que define la lógica de conexión a la API de Ollama.
Data Formatter – Permite transformar la salida de búsqueda en formatos más legibles o estructurados.
Text Summarizer – Puede resumir los fragmentos de texto obtenidos en la búsqueda para una lectura rápida.

Consejos y Mejores Prácticas

Limita la cantidad de resultados: Un valor bajo (por ejemplo, 3 o 5) reduce la latencia y la cantidad de datos que debes procesar.
Usa consultas claras: Cuanto más específica sea la consulta, más relevantes serán los resultados.
Combina con filtros: Después de obtener los resultados, utiliza filtros de texto o de URL para eliminar contenido irrelevante.
Monitorea el uso de la API: La API de Ollama Cloud puede tener límites de tasa; revisa tu plan y ajusta el número de consultas en batch si es necesario.
Prueba en modo de mapeo: Si necesitas buscar información para varios registros, activa Mapping Mode y conecta la entrada “Mapping Data” a la fuente de datos.

Consideraciones de Seguridad

Protege tu API Key: La credencial de Ollama Cloud API debe mantenerse confidencial. No la compartas en flujos públicos ni la incluyas en archivos de código.
Control de acceso: Asegúrate de que solo usuarios autorizados puedan crear o editar credenciales y componentes que las utilicen.
Revisa los logs: Los registros de llamadas a la API pueden contener información sensible; configúralos para que se almacenen de forma segura y se eliminen cuando ya no sean necesarios.

Con estos pasos, podrás integrar búsquedas web en tus flujos de trabajo de Nappai de manera sencilla, segura y eficiente.