Basic Agent

Bienvenido al Basic Agent (Agente Básico), el cerebro conversacional de tu automatización en Nappai. Este componente actúa como un asistente inteligente capaz de entender tus preguntas y, lo más importante, utilizar herramientas externas (como buscadores de internet o bases de datos) para encontrar las respuestas más precisas.

Piensa en él como un empleado virtual: tú le haces una pregunta y él busca la información necesaria para responderte. A diferencia de un chat simple, este agente está diseñado para ser “proactivo”, usando las herramientas que tú le configures para completar su tarea.

¿Cómo funciona?

El Basic Agent utiliza modelos de lenguaje avanzados (LLMs) para procesar lo que le escribes. Su funcionamiento sigue estos pasos sencillos:

Recibe tu pregunta: Lee el texto que introduces en el campo de entrada.
Decide si necesita ayuda: El agente analiza tu pregunta. Si la respuesta está en su conocimiento general, te la da directamente. Si necesita datos en tiempo real (como el clima o precios de acciones), decide usar una “herramienta” conectada.
Ejecuta acciones: Si usa una herramienta, consulta la información externa de manera automática.
Responde: Finalmente, te devuelve una respuesta clara y concisa.

Importante sobre el estado del componente: Actualmente, este componente se encuentra en modo de desarrollo. Esto significa que es una herramienta potente pero que aún se está afinando. Es posible que en algunas ocasiones las respuestas no sean perfectas o que haya pequeños fallos al cargar las herramientas. Se recomienda usarlo para pruebas y flujos de trabajo estándar, vigilando siempre que las automatizaciones se ejecuten como esperas.

Entradas

Para que el agente funcione correctamente, puedes configurar varios aspectos. Todos los nombres de los campos se muestran en inglés tal como aparecen en la interfaz.

Input: El texto principal de la pregunta o instrucción. Es lo que le pedirás al agente.
Messages: (Opcional) El historial de la conversación. Útil si quieres que el agente recuerde lo que se ha dicho en mensajes anteriores dentro de la misma sesión.
Tools: (Opcional) La lista de herramientas disponibles. Aquí conectas las “brazos” del agente (ej. una calculadora, un buscador web). Si no conectas nada, el agente solo podrá responder con lo que ya sabe.
System Prompt: Instrucciones de fondo para el agente. Defines cómo debe comportarse (ej. “responde siempre en español” o “sé muy formal”).
Agent Name: El nombre que tendrá el agente si lo usas como parte de otra tarea más compleja.
Agent Description: Una breve descripción del propósito del agente, útil para que otros componentes o usuarios entiendan para qué sirve.
Memory Limit: Un número que indica cuántos mensajes guardar en la memoria. Si pones -1, la memoria es ilimitada.
Model: La potencia del cerebro del agente. Puedes seleccionar qué modelo de lenguaje utilizar.
Stream: Si activas esta opción, verás la respuesta aparecer en tiempo real, palabra por palabra, en lugar de esperar a que se complete toda la respuesta.
Use Memory: Un interruptor para activar o desactivar la memoria de la conversación. Útil si quieres que el agente recuerde el contexto previo.
External Checkpointer: (Avanzado) Una configuración para guardar el estado de la conversación en una base de datos externa. Generalmente no es necesario usarlo para flujos simples.

Conectividad

El Basic Agent es un nodo versátil. Suele conectarse de las siguientes maneras en un flujo de trabajo:

Entrada (Input): Recibe datos de componentes previos como “Text Input” (donde escribes la pregunta) o de la salida de otros agentes si se trata de una conversación en cadena.
Salida (Response): Conecta la respuesta del agente a otros componentes para procesarla. Por ejemplo:
- A un Email Node para enviar la respuesta por correo.
- A un Database Node para guardar la respuesta.
- A un Text Editor para modificar la respuesta antes de mostrarla.

Ejemplo de Uso

Imagina que estás creando un asistente para tu departamento de ventas.

Conectas un componente “Text Input” al campo Input del Basic Agent, donde el usuario escribe: “¿Cuál es la tasa de interés actual del hipotecario?”.
Conectas una herramienta “Web Search” al campo Tools del Basic Agent.
Cuando el flujo se ejecuta, el Basic Agent recibe la pregunta, usa la herramienta de búsqueda para encontrar el dato actual en internet y devuelve la respuesta exacta en el campo Response.

Consejos y Mejores Prácticas

Sé específico: Las preguntas claras dan mejores respuestas. En lugar de preguntar “¿Cuánto es?”, pregunta “¿Cuál es el resultado de sumar 10 y 20?”.
Paciencia con las herramientas: Si el agente decide usar una herramienta (como buscar en Google), puede tardar unos segundos más en responder. No hagas clic repetidamente, deja que termine de buscar.
Revisa las respuestas críticas: Dado que el agente está en desarrollo, verifica siempre la información sensible (precios, datos legales) antes de usarla en procesos automáticos importantes.

Consideraciones de Seguridad

Ten en cuenta que este agente puede enviar tu pregunta a servicios externos (como los proveedores de inteligencia artificial). Por lo tanto:

No compartas información sensible: Evita poner contraseñas, números de tarjetas de crédito o datos personales confidenciales en la pregunta (Input), ya que podrían ser transmitidos a servidores externos.