Runnable With Message History

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

Este componente permite ejecutar un agente con historial de mensajes, intentando adivinar las claves de entrada y salida. Es útil cuando quieres que Nappai recuerde el contexto de una conversación o proceso sin tener que especificar manualmente las claves de entrada y salida.

¿Cómo funciona?

Internamente, el componente toma los mensajes almacenados en la memoria (ya sea la interna de Nappai o una memoria externa que proporciones) y los pasa al agente especificado. El agente se ejecuta y devuelve una respuesta que se guarda de nuevo en la memoria. El componente intenta deducir automáticamente qué claves de entrada y salida usar, lo que simplifica la configuración cuando el flujo de datos es estándar.

Entradas

External Memory: Recupera mensajes de una memoria externa. Si está vacía, se utilizará la memoria interna de Nappai.
Agent Executor: El ejecutor del agente que se va a usar. Este campo es obligatorio.
Executor Name: El nombre del ejecutor que se debe usar.
Input Key: La clave que se usará para pasar la entrada al agente.
Input: El mensaje de entrada que se enviará al agente.
Memory top message: Número de mensajes superiores que se incluirán en la memoria.
Number of extra input parameters: Número de parámetros de entrada adicionales que se pasarán al agente.
Output Key: La clave que se usará para capturar la salida del agente.
Stream: Indica si la respuesta debe transmitirse en tiempo real.

Salidas

Text: Mensaje generado por el agente (tipo Message). Se puede usar directamente en otros componentes o mostrarlo al usuario.

Ejemplo de Uso

Arrastra el componente Runnable With Message History al lienzo.
Conecta la salida Text a un componente de visualización de texto para mostrar la respuesta al usuario.
Configura Agent Executor con el ejecutor que deseas usar (por ejemplo, un agente de generación de texto).
Deja los campos Input Key y Output Key vacíos para que el componente los adivine automáticamente.
Ejecuta el flujo y observa cómo el agente procesa el historial de mensajes y devuelve la respuesta.

Componentes Relacionados

Runnable – Ejecuta un agente sin historial de mensajes.
Agent Executor – Define la lógica y los parámetros del agente que se ejecutará.
Memory – Gestiona el almacenamiento y recuperación de mensajes.

Consejos y Mejores Prácticas

Usa la memoria interna cuando no necesites compartir datos entre flujos; evita la configuración de una memoria externa innecesariamente.
Revisa las claves de entrada y salida cuando el flujo de datos sea complejo; aunque el componente intenta adivinarlas, especificarlas explícitamente reduce errores.

Consideraciones de Seguridad

El componente no hace llamadas a servicios externos, por lo que no hay riesgo de exponer datos a terceros. Sin embargo, asegúrate de que la memoria interna esté protegida y que los mensajes sensibles se manejen con las políticas de privacidad de tu organización.