Conceptos Clave

Para dominar NappAI, es importante entender sus cinco conceptos fundamentales. Piensa en ellos como las piezas de un set de construcción: una vez que conoces cada pieza, puedes construir cualquier cosa.

Proyectos (Flujos)

Un Proyecto es el lienzo completo donde diseñas tu automatización. Es el “plano” de tu trabajo y el término principal que usamos en NappAI. A veces nos referiremos a la lógica interna de un proyecto como un Flujo. Contiene todos los componentes y las conexiones entre ellos, representando el proceso completo de principio a fin.

• Analogía: Un Flujo es la receta completa de una comida.

Componentes (o Nodos)

Los Componentes son los bloques de construcción individuales que colocas en tu flujo. Cada componente tiene una tarea específica y única: recibir un mensaje de chat, conectarse a una base de datos, llamar a un modelo de IA, etc.

• Analogía: Si el Flujo es la receta, los Componentes son los ingredientes y los electrodomésticos (un horno, una batidora, etc.).

Agentes

Un Agente no es un componente común. Es un componente avanzado que actúa como un “director de orquesta” o un “cerebro”. En lugar de solo realizar una tarea, un Agente puede tomar decisiones, usar herramientas (como otros modelos o componentes) y gestionar una lógica compleja para lograr un objetivo.

• Analogía: Un Agente es el Chef experto que, en lugar de seguir la receta al pie de la letra, puede improvisar, elegir los mejores ingredientes y decidir el mejor curso de acción para crear el plato perfecto.

System Prompt vs. User Prompt

Cuando configuras un Agente o un componente de Modelo de Lenguaje (LLM), te encontrarás con dos tipos de “prompts” o instrucciones. Entender su diferencia es clave:

System Prompt (Indicador del Sistema)

Es la instrucción principal y persistente que define la personalidad, el objetivo y las reglas de comportamiento del Agente. Se envía al LLM en cada interacción y actúa como su “constitución”.

• Propósito: Definir el rol (“Eres un experto en finanzas”), establecer restricciones (“Solo responde basándote en las herramientas”) o fijar el formato de la salida (“Responde siempre en formato JSON”).
• Analogía: Es el briefing de la misión que un agente secreto lee antes de empezar a trabajar.

User Prompt (Entrada del Usuario)

Es la instrucción variable y específica que el usuario final introduce en cada turno de la conversación. Es la pregunta o comando que el Agente debe resolver en ese momento.

• Propósito: Representar la consulta actual del usuario (“¿Cuál fue el precio de las acciones de Apple ayer?”).
• Analogía: Es la orden específica que el agente secreto recibe por radio durante la misión.

Credenciales

Las Credenciales son la forma segura en que NappAI almacena la información de acceso para conectarse a otros servicios, como tus claves API de Google, OpenAI o cualquier otra plataforma. Guardas tu clave una vez como una credencial y luego puedes reutilizarla en cualquier componente sin tener que volver a escribirla.

• Analogía: Las Credenciales son el juego de llaves que le das a NappAI para que pueda acceder de forma segura a tus otras herramientas y servicios.

Conceptos Nativos de NappAI

Además de reinterpretar los conceptos clásicos, NappAI introduce modos de operación específicos para potenciar tus flujos.

Tool Mode

El Tool Mode permite convertir componentes versátiles de NappAI, que usualmente operan de forma secuencial, en herramientas utilizables dentro de un flujo de IA Funcionamiento:

1. Conexión: Para activar el Tool Mode, se debe conectar el conector tool del componente con el conector tool del Agente de Inteligencia Artificial.
2. Transformación: Al realizar esta conexión, las otras maneras de heredar los datos desaparecen, y los componentes se convierten en herramientas de inteligencia artificial.
3. Reconocimiento de Propiedades: Las propiedades del componente se reconocen automáticamente. Se indica, mediante un botón, que el componente recibirá estas propiedades, las cuales antes debían provenir directamente del agente como parámetros de la interacción.
4. Nombres y Descripción: Cada herramienta tiene un nombre (por ejemplo, sheet at row para el componente de Google Sheet) y una descripción.
5. Orquestación: De esta forma, el agente puede utilizar los componentes, a partir de la conexión, como una herramienta que puede ser orquestada como parte del flujo de automatización.

Batch Mode

El Batch Mode es una funcionalidad introducida en los componentes de NappAI que está diseñada para manejar estructuras de datos complejas que no son simples datos de texto Funcionamiento:

1. Activación: Cuando se habilita el mapping mode, NappAI transforma la entrada de datos del componente.
2. Enlace de Objetos: Se crea una opción que permite enlazar directamente con objetos de datos de otros componentes.
3. Mapeo Directo: Al acceder a la opción de mapear, el usuario puede arrastrar directamente el objeto que desea asignar a un campo, basándose en la estructura del componente anterior.
4. Uso de JavaScript (Opción Avanzada): Además de la opción directa, se puede usar la opción de JavaScript. Esta opción también habilita la estructura de datos del componente anterior para que pueda ser insertada en el nuevo componente.
5. Combinación de Datos: El modo JavaScript permite no solo obtener datos de la estructura anterior, sino también combinarlos con código en el momento del mapeo, creando un dato nuevo para el componente (por ejemplo, combinando un ID de carpeta con el texto “nuevo”)