Conceptos clave
Estas son las ideas que vas a encontrar en todas las pantallas de NappAI. Si las tienes claras, el resto de la documentación se lee mucho más fácil.
Proyecto y flujo
Un flujo es una automatización: una serie de pasos que reciben información, hacen algo con ella y devuelven un resultado. Cada flujo vive dentro de un proyecto, y en la práctica las dos palabras significan lo mismo. La pantalla Proyectos los reúne todos, organizados en carpetas.
Ver Proyectos.
Componentes
Un componente es cada uno de los pasos de un flujo. Cada componente hace una sola cosa: recibir un mensaje, consultar un modelo de IA, leer una hoja de cálculo, enviar un correo, decidir por qué camino seguir…
En el editor eliges los componentes en un panel organizado por categorías, como Principales, Datos, A.I., Operaciones o Integraciones. Cada componente tiene un panel de ajustes con sus campos.
Ver Añadir componentes. Cada componente tiene su propia página en la sección Componentes de esta documentación.
Conexiones
Los componentes se unen con conexiones. Cada componente tiene puntos de entrada a un lado y puntos de salida al otro; al conectar la salida de uno con la entrada de otro, lo que produce el primero pasa al segundo.
Solo se pueden unir puntos compatibles: el editor atenúa los demás mientras arrastras. Así el flujo se lee de izquierda a derecha, en el orden en que pasa la información.
Entradas y salidas del flujo
Todo flujo empieza por algo que lo pone en marcha y termina en un resultado:
- Entradas: un mensaje de chat (Chat Input), un texto (Text Input), una llamada desde otra aplicación (Webhook Input), un aviso de un servicio conectado, una llamada de teléfono (Voice Agent)…
- Salidas: la respuesta en el chat (Chat Output), un texto (Text Output), un correo enviado, una fila nueva en una hoja de cálculo, un documento…
Un flujo también puede ejecutarse solo, en las fechas que elijas, con el Programador.
Modelos de IA
Un modelo es la inteligencia artificial que entiende y redacta texto. NappAI tiene un componente para cada proveedor de modelos, como OpenAI, Gemini o Anthropic. En cada uno eliges la credencial de ese proveedor y el modelo concreto en Model Name.
Un modelo se puede usar solo, para responder a un texto, o conectado a un agente para que piense por él.
Agentes
Un agente es un componente que usa un modelo para resolver una petición. A diferencia de un paso fijo, el agente lee la petición, decide qué hacer y, si le has dado herramientas, elige cuál usar y en qué orden antes de responder.
El componente Agent tiene dos puntos de conexión abajo: Model, donde conectas el modelo que usa, y Tools, donde conectas sus herramientas.
Ver Agent.
Instrucciones del agente
En los ajustes del agente hay dos textos distintos:
| Campo | Qué es | Ejemplo |
|---|---|---|
| System Prompt | Las instrucciones fijas: quién es el agente, qué debe hacer, qué información tiene y qué no debe hacer. Se aplican a todas las conversaciones. | Eres el asistente de una tienda de muebles. Responde de forma breve y en el idioma del cliente. |
| User Prompt | La petición de cada momento. Por defecto es {input}, el hueco donde llega lo que entra por la conexión Input. | La pregunta que escribe el cliente en el chat. |
Si el agente no responde como esperas, revisa primero el System Prompt: cuanto más concretas sean las instrucciones y la información que le das, más fiables son las respuestas.
Herramientas
Una herramienta es un componente que el agente puede usar cuando lo necesita: buscar en una hoja de cálculo, consultar el calendario, enviar un correo, ejecutar otro flujo…
Para dárselo, conecta el punto Tool, en la parte de arriba del componente, al punto Tools del agente. El agente decide en cada conversación si lo usa y con qué datos. En los ajustes del componente, cada campo tiene un botón que lo deja en manos de la IA (Definido por IA): así el agente lo rellena según la conversación. Los campos que no marques los fijas tú.
Un agente puede tener varias herramientas a la vez. Describe en el System Prompt cuándo debe usar cada una.
Batch Mode (modo lote)
Cuando a un componente le llega una lista, como las filas de una hoja de cálculo, Batch Mode le hace procesar cada elemento y devolver todos los resultados juntos. Se activa en los ajustes del componente; al activarlo, el componente recibe la lista por su punto Batch Input y cada campo puede tomar un valor fijo (Fixed) o un dato de cada elemento (Mapped).
Ver Procesar listas.
Credenciales
Una credencial es el acceso guardado a un servicio externo: la clave de un proveedor de modelos, tu cuenta de Gmail, un bot de Telegram… La guardas una vez y la eliges en todos los componentes que la necesiten. Después de guardarla, la clave no se vuelve a mostrar.
Ver Credenciales.
El playground
El Entorno de Pruebas, o playground, ejecuta el flujo desde el editor para que veas el resultado al momento. Si el flujo empieza por un Chat Input, se usa como un chat. A la izquierda puedes ver qué recibió y qué devolvió cada componente.
Ver Probar el flujo en el playground.
Borrador, versión y publicación
Lo que editas en el lienzo es el borrador del flujo, y se guarda solo. Una versión es una copia con nombre del flujo en un momento dado. Publicar es desplegar una versión: es la que usan las otras aplicaciones, las ejecuciones programadas, los canales conectados y las llamadas de teléfono.
El playground siempre ejecuta el borrador. Así puedes seguir probando cambios sin afectar a quien ya usa el flujo.
Ejecuciones
Una ejecución es cada vez que un flujo se pone en marcha. NappAI guarda lo que hizo cada componente en cada ejecución, y lo consultas en Reg. de Ejecuciones.
Entornos
Un entorno es un conjunto de valores con nombre que puedes asociar a un flujo, por ejemplo la dirección de un servicio o un identificador de cliente. Te permite usar unos valores mientras pruebas y otros en producción sin cambiar el flujo.
Ver Entornos.
Para seguir
- Lógica de un flujo: decisiones, repeticiones y flujos reutilizables.
- Cómo viaja la información: textos, registros, listas y archivos.
- Glosario: las palabras de NappAI en una frase.