Simple Agent

`Agente Simple`

El Agente Simple es el punto de partida recomendado para construir la mayoría de las soluciones de IA en NappAI. Ofrece un equilibrio perfecto entre potencia y facilidad de uso, permitiendo crear agentes conversacionales y de automatización que pueden utilizar herramientas sin necesidad de configuraciones complejas.

Este componente está diseñado para ser la columna vertebral de tus flujos de IA, proporcionando las capacidades esenciales de razonamiento, uso de herramientas y gestión de memoria.

Casos de Uso Principales

Utilice el Agente Simple cuando su objetivo sea:

Construir un chatbot que pueda responder preguntas utilizando herramientas.
Crear un asistente que ejecute tareas específicas (ej. enviar un correo, consultar una API).
Orquestar un flujo de trabajo donde la IA deba decidir qué herramienta usar en función de la entrada del usuario.
Prototipar rápidamente soluciones de IA antes de pasar a arquitecturas más complejas.

Configuración (Pestaña Común)

Estos son los parámetros esenciales para definir el comportamiento de tu agente.

Parámetro	Descripción Técnica	Propósito en el Flujo
`Nombre Del Agente`	Un nombre descriptivo para el agente.	Se utiliza para identificar al agente, especialmente cuando se expone como una herramienta para otro agente más grande (un “supervisor”).
`Descripción Del Agente`	Una descripción clara y concisa de lo que hace el agente.	Es crucial cuando se usa como herramienta. El agente supervisor leerá esta descripción para entender cuándo debe delegar una tarea a este sub-agente.
`Aviso Al Usuario (User Prompt)`	La plantilla que formatea la entrada del usuario antes de ser procesada.	Permite añadir contexto o estructurar la pregunta del usuario. La variable `{input}` se reemplazará automáticamente con el texto del usuario.
`Aporte (Input)`	La entrada de datos directa para el agente.	Este es el campo principal donde se conecta la pregunta del usuario, generalmente desde un `Chat Input` u otro componente.
`Indicador Del Sistema (System Prompt)`	La instrucción persistente que define el rol, la personalidad, las reglas y el objetivo del agente.	Actúa como la “constitución” del agente, guiando su razonamiento y asegurando un comportamiento consistente.
`Herramientas (Tools)`	Conexión para los componentes que el agente puede utilizar.	Conecta aquí las herramientas (ej. `Web Search`, `API Request`) que quieres poner a disposición del agente.
`Modelo (Model)`	Conexión al Modelo de Lenguaje (LLM) que potenciará el razonamiento del agente.	Es el “motor cognitivo” del agente. Conecta aquí un componente como `Gemini` u `OpenAI`.

Configuración (Pestaña Avanzado)

Estos parámetros te permiten afinar el rendimiento, la producción y la gestión de memoria de tu agente.

Control de Ejecución

ID del componente: Un identificador único generado automáticamente para este componente en tu flujo.
Iteraciones Máximas: Establece el número máximo de ciclos de pensamiento (pasos de razonamiento) que el agente puede realizar en una sola ejecución. Es una medida de seguridad para evitar bucles infinitos y controlar el consumo de recursos.

Producción

Utilice Salida Estructurada: Si se activa, obliga al agente a generar su respuesta final en un formato JSON estricto, definido por un esquema. Es esencial cuando la salida del agente necesita ser procesada de forma automática por otro sistema.
Arroyo (Stream): Permite que la respuesta del agente se envíe palabra por palabra (en streaming), en lugar de esperar a que se genere la respuesta completa. Mejora la experiencia de usuario percibida en aplicaciones de chat.
Incluir El Estado En La Respuesta: Si se activa, la salida del agente incluirá no solo la respuesta textual, sino también el estado interno completo del agente (memoria, pasos intermedios, etc.). Útil para depuración avanzada.

Memoria

Usar La Memoria: Activa la memoria conversacional. Cuando está habilitado, el agente recordará interacciones pasadas en la misma sesión, permitiendo mantener conversaciones coherentes.

Configuración (Pestaña Herramienta)

Esta pestaña configura cómo se comporta este agente cuando es utilizado como una herramienta por otro agente supervisor.

Parámetro	Descripción Técnica
`Nombre de la Herramienta`	El nombre que el agente supervisor verá y usará para invocar a este sub-agente.
`Descripción de la Herramienta`	La descripción que el agente supervisor leerá para decidir si debe delegar una tarea a este sub-agente. ¡Debe ser muy clara y descriptiva!
`Modo de respuesta de la herramienta`	Define cómo la respuesta de este sub-agente afectará al estado del agente supervisor. `Standard` es la opción más común.

Configuración (Pestaña Modo por lotes)

Modo por lotes (Batch Mode): Activa el procesamiento en lote. Si conectas una lista de entradas (en lugar de una sola), el agente se ejecutará una vez para cada elemento de la lista, procesando todas las tareas de forma paralela y eficiente.