Saltearse al contenido
Nappai Documentation

Guía de inicio rápido

¡Bienvenido a NappAI! En esta guía, te llevaremos de la mano para que construyas tu primera automatización: un chatbot simple que responde a tus preguntas utilizando la IA de Google.

Lo que construirás

Crearás un flujo con cuatro componentes (nodos) esenciales que reciben tu pregunta, la procesan con una IA y te devuelven una respuesta en una interfaz de chat.

Prerrequisitos

Para seguir este tutorial, solo necesitarás:

  • Una cuenta de NappAI.
  • Una Clave API de Google Generative AI. Puedes obtener una gratis aquí.

Construyendo tu Primer Proyecto

Paso 1: Crear un Proyecto Vacío

Empecemos desde un lienzo en blanco para entender cada pieza.

  1. En el dashboard principal, haz clic en + Nuevo Proyecto. Botón de Proyectos

  2. Selecciona la plantilla Proyecto Vacío y luego haz clic en Usar esta plantilla. Plantilla de proyecto vacío

  3. ¡Perfecto! Ya estás en la vista del proyecto. Haz clic en Agregar tu primer componente para empezar. Vista de proyectos

Paso 2: Añadir los Componentes al Flujo

Ahora vamos a añadir los “ladrillos” de nuestra automatización. En NappAI, los componentes están organizados en categorías para que encuentres fácilmente lo que necesitas: Core, AI Nodes, Databases, etc.

Menú de componentes mostrando las categorías.

Para este flujo inteligente, necesitamos los siguientes componentes:

  1. Chat Input: Recibe los mensajes del usuario.
  2. Agent: Actúa como el “director” de la operación, coordinando la lógica y el uso de herramientas.
  3. Gemini: El modelo de IA de Google, que funcionará como el “cerebro” que el agente utilizará.
  4. Chat Output: Muestra la respuesta final en la interfaz.

Para añadirlos, simplemente encuéntralos en el menú de la derecha y arrástralos uno por uno al área de trabajo.

Paso 3: Conectar los Componentes

La conexión con un Agente es especial. Hay un flujo principal de datos y una conexión para el modelo.

  1. Conecta el flujo principal: Haz clic en el punto de salida de Chat Input y arrástralo a la entrada Input del Agent. Luego, conecta la salida Text del Agent a la entrada del Chat Output.
  2. Conecta el Modelo al Agente: Haz clic en el punto de salida del componente Gemini y arrástralo al punto de entrada llamado Model en la parte inferior del Agent.

Tu flujo final debería verse exactamente así: Flujo completo con el Agente y Gemini conectados.

Paso 4: Configurar los Componentes

Ahora, demos las instrucciones a cada componente. Haz clic en cada uno para abrir su configuración.

  1. Entrada del Chat: No necesita configuración. ¡Fácil!

  2. Geminis: Aquí es donde configuras el acceso al modelo de IA.

    • Haz clic en Crear Nueva credencial.

    • Agrega un nombre para la credencial.

    • Pega tu Clave API de Google que obtuviste en los prerrequisitos.

    • Una vez agregada la credencial selecciona el modelo (Ej gemini-2.0-flash)

  3. Agente: ¡Aquí es donde ocurre la magia! Esta es la configuración principal.

    • Nombre del Agente: Puedes ponerle un nombre descriptivo, como ReactAgent.
    • Indicador del Sistema (System Prompt): Este es el cerebro del agente. Define su personalidad y su tarea principal. Pega el siguiente texto, que es muy similar al del prompt anterior: 
      Eres un asistente servicial y creativo. Responde a la pregunta del usuario de forma clara y concisa.
      

      Pregunta del usuario(io: {{aporte}})

    Importante: Nota que la variable para la entrada del usuario aquí es {{aporte}}. El Agente recibe la información en esta variable.

    Panel de configuración del componente Agente.

  4. Salida del Chat: Tampoco necesita configuración.

Paso 5: ¡Probar tu Chatbot!

¡Has llegado al final! Es hora de ver tu creación en acción.

En la parte derecha de la pantalla, verás el Entorno de Pruebas que tiene ícono de insecto. Entorno_de_prueba.
Presiónalo y abrirá el espacio de prueba. Espacio de prueba. Escribe una pregunta en el campo de texto y presiona Enter. En unos segundos, la IA te responderá.

¡Felicidades! Has construido y probado tu primer flujo de trabajo con IA en NappAI.

¿Y ahora qué? Próximos Pasos

Ya dominas lo básico. ¿Por qué no pruebas algo más?