Runnable Executor

El Runnable Executor permite ejecutar cualquier objeto que implemente la interfaz de un runnable (por ejemplo, un agente, una cadena o un ejecutor de agente) directamente desde tu panel de control. Solo necesitas introducir el texto que quieres procesar y el componente se encargará de pasar ese texto al objeto, recoger la respuesta y mostrártela de forma legible.

¿Cómo funciona?

Cuando introduces un valor de texto en el campo Input, el componente construye un diccionario con la clave que tú indiques en Input Key (por defecto “input”). Este diccionario se envía al objeto Agent Executor que hayas conectado. El objeto procesa la información y devuelve un resultado que puede contener varias claves. El componente intenta identificar la clave que contiene la respuesta real (puede ser “answer”, “response”, “output”, “result” o “text”) y la muestra en la salida Text. Si el resultado no contiene ninguna de esas claves, el componente simplemente devuelve el valor que haya recibido.

El componente también permite ver la respuesta en tiempo real si activas la opción Stream. En ese caso, la respuesta se va mostrando a medida que el agente la genera, lo que es útil para diálogos largos o procesos que tardan.

Entradas

Agent Executor: Conecta el objeto que quieres ejecutar (por ejemplo, un agente o una cadena).
Input Key: Especifica el nombre de la clave que el objeto espera para recibir el texto.
Input: Escribe el texto que quieres enviar al objeto.
Output Key: Indica la clave que el objeto usará para devolver la respuesta (puede dejarse en el valor por defecto “output”).
Stream: Activa o desactiva la visualización de la respuesta en tiempo real.

Salidas

Text: El resultado procesado por el objeto conectado, presentado como un mensaje de texto. Puedes usar esta salida para alimentar otros componentes o para mostrarla directamente en tu dashboard.

Ejemplo de Uso

Arrastra el componente Runnable Executor al lienzo.
Conecta el objeto Agent Executor que ya tienes configurado (por ejemplo, un agente que responde preguntas).
Deja el Input Key y el Output Key con sus valores por defecto.
Escribe en Input la pregunta: “¿Cuál es la capital de Francia?”.
Desactiva Stream si no necesitas la respuesta en tiempo real.
Ejecuta el flujo.
La salida Text mostrará: “La capital de Francia es París.”

Componentes Relacionados

Chain: Secuencia de pasos que pueden ser ejecutados por el Runnable Executor.
Agent: Entidad que toma decisiones basadas en el contexto y produce respuestas.
Runnable: Cualquier objeto que implemente la interfaz de ejecución.

Consejos y Mejores Prácticas

Usa claves claras: Si tu objeto espera una clave diferente a “input”, cambia el valor de Input Key para evitar confusiones.
Revisa la salida: Si la respuesta no aparece en Text, verifica que el objeto devuelva una de las claves reconocidas (“answer”, “response”, etc.).
Activa Stream para diálogos largos: Cuando el proceso tarda varios segundos, habilitar la opción Stream mejora la experiencia del usuario al mostrar la respuesta progresivamente.
Conecta componentes de forma lógica: Coloca el Runnable Executor después de cualquier componente que genere el texto de entrada (por ejemplo, un componente de extracción de datos).

Consideraciones de Seguridad

El Runnable Executor ejecuta código que proviene del objeto conectado. Asegúrate de que el objeto Agent Executor no contenga instrucciones que puedan comprometer la seguridad de tu sistema (por ejemplo, acceso a archivos sensibles o a la red). Si trabajas con datos confidenciales, revisa las políticas de privacidad y los permisos del agente antes de usarlo en producción.