🌱 ¿Nuevo por aquí?
Este módulo es una referencia: no necesitas memorizarlo todo de una vez. Cada término viene con una definición breve e un ejemplo concreto, porque una definición sin ejemplo se recuerda menos. Usa el índice de la derecha para saltar al grupo que necesitas — y vuelve cada vez que encuentres una palabra nueva en las otras rutas.
Los siete clusters siguen el flujo de quien está empezando: primero las ideas de IA, después cómo hablar con el asistente (modos), luego los archivos donde se configura todo, después cómo conectar herramientas (MCP) y, por último, n8n —desde lo básico hasta la IA— y los bloques de datos que alimentan las respuestas.
Diagrama ilustrativo — los grupos del glosario en orden de aprendizaje. Cada cuadro es un tema a continuación, con sus términos definidos.
🧠 Conceptos de IA
Qué es
Este grupo es el alfabeto de la IA. Antes que nada: LLM (large language model, «modelo de lenguaje grande») es el tipo de IA que entiende y genera texto; es el «motor» detrás del asistente. Hablas con él por medio de un prompt: el mensaje que escribes. Encima de cada conversación está el system prompt, una instrucción de fondo (rol, contexto, reglas) que se aplica a toda la sesión.
Todo lo que el LLM «ve» en ese momento es el contexto (o context window, «ventana de contexto») — el espacio de memoria de la conversación. Ese espacio se mide en tokens: fragmentos de palabras que cuenta la IA. Y hay un efecto que debes temer: el context rot ("deterioro del contexto"), la caída de calidad cuando la ventana se llena de historial y el modelo empieza a equivocarse más.
GlosarioConceptos de IA
- LLM
- IA que entiende y genera texto. Ej.: escribes "resume este correo" y te devuelve el resumen.
- Prompt
- El mensaje que envías. Ej.: «crea un workflow que revise el correo electrónico cada 10 min».
- System prompt
- Instrucción de fondo de la sesión (rol, reglas). Ej.: «eres mi asistente de workflows de n8n».
- Contexto / context window
- Todo lo que la IA ve ahora (la memoria de la conversación). Ej.: los archivos y mensajes ya intercambiados.
- Token
- Fragmento de palabra que cuenta la IA; las conversaciones largas consumen más. Ej.: «automatización» ≈ algunos tokens.
- Context rot
- Caída de calidad cuando la ventana se llena. Ej.: después de mucho historial, la IA olvida una regla inicial.
Por qué aprender
Estos seis términos explican por qué el asistente a veces «olvida» o se equivoca: la conversación creció, la ventana se llenó, el contexto se deterioró. Saberlo te da el reflejo correcto: iniciar sesiones enfocadas y limpiar el contexto antes de que baje la calidad (aprendes cómo hacerlo en los modos, más adelante).
Conceptos clave
El motor que genera texto.
Tu mensaje.
La memoria de la conversación.
La unidad de lo que lee.
🎛️ Modos del asistente
Qué es
El asistente tiene modos de permiso que controlan cuánto actúa por su cuenta. El plan mode (modo de planificación) es donde investiga, hace preguntas y propone un plan antes de cambiar algo: primero tú lo apruebas. En el otro extremo, el bypass permissions ("omitir permisos") le permite actuar sin pedir aprobación en cada paso: es rápido, pero dejas de ver lo que hace, así que úsalo con cuidado.
Para gestionar el contexto (que viste deteriorarse), hay dos comandos: /clear reinicia toda la conversación — úsalo al cambiar de tarea o cuando la calidad baje; /compact hace un resumen inteligente, conservando lo esencial y comprimiendo el resto; úsalo a mitad de una tarea cuando el contexto se hace extenso.
GlosarioModos y comandos
- Plan mode (modo de planificación)
- Investigación + preguntas + plan, antes de ejecutar. Ej.: describes la meta y revisas su plan.
- Permission modes (modos de permisos)
- Cuánto actúa el asistente por su cuenta: preguntar antes, editar automáticamente, plan, auto. Ej.: «preguntar antes de editar».
- Bypass permissions
- Omite la aprobación en cada paso; es veloz, pero pierdes visibilidad. Ej.: activado para una compilación larga ya aprobada.
/clear- Restablece la conversación desde cero. Ej.: al cambiar de proyecto o cuando empieza a cometer errores.
/compact- Resumen inteligente: conserva lo que importa. Ej.: en medio de una tarea larga, cerca de ~70% del contexto.
Por qué aprender
Estos comandos son tu «embrague». Empezar en plan mode evita que la IA construya algo equivocado; /compact e /clear mantienen la calidad alta y el costo de tokens bajo. La regla práctica: piensa en compactar cuando el contexto esté cerca del 70% y en limpiar al superar el 85% o al cambiar de tarea.
✓ Buen uso de los modos
- ✓Empezar en plan mode para tareas que no sean triviales.
- ✓
/compacta mitad de camino;/clearal cambiar de tarea. - ✓Bypass solo después de aprobar el plan.
✗ Qué evitar
- ✗Bypass desde el inicio, sin ver qué hace.
- ✗Reutilizar una conversación sobrecargada para algo nuevo.
- ✗Insistir en un contexto degradado en vez de limpiarlo.
Conceptos clave
Planifica antes de actuar.
Rápido, pero a ciegas.
Restablecimiento total.
Resumen inteligente.
🗂️ Archivos clave
Qué es
Un proyecto de vibe coding gira en torno a algunos archivos. El más importante es el CLAUDE.md: un system prompt persistente, escrito en markdown, que define quién es el asistente, qué construyes y cuáles son tus preferencias; se lee en cada sesión. El .env guarda los secretos (claves de API), y el .gitignore enumera qué nunca debe subirse a la nube — y el .env siempre está en esta lista.
Para conectar herramientas, existe el .mcp.json: el archivo que registra los servidores MCP del proyecto (pero la clave en sí queda en el .env, nunca aquí). Y cuando empaquetas una instrucción reutilizable, se convierte en un SKILL.md dentro de la carpeta de skills: el "manual" de esa skill.
GlosarioArchivos del proyecto
- CLAUDE.md
- System prompt persistente en markdown (rol, contexto, reglas, estilo). Ej.: «eres mi asistente de n8n; sé conciso».
.env- Archivo de secretos (claves de API), fuera del código. Ej.: la clave de n8n y la URL de la instancia están aquí.
.gitignore- Lista de lo que no se sube a GitHub. Ej.: el
.enventra aquí para que la clave nunca se filtre. .mcp.json- Registro de los servidores MCP del proyecto (sin la clave). Ej.: la entrada del server + un espacio reservado para una clave.
- SKILL.md
- El «manual» de una skill (nombre, descripción, argumentos, pasos). Ej.: la skill
/rascunhar-email.
Por qué aprender
Conocer estos archivos es saber dónde está cada cosa: reglas de sesión en CLAUDE.md, secretos en el .env, herramientas en el .mcp.json, skills en SKILL.md. Eso evita el error más peligroso de los principiantes: pegar una clave de API en el lugar equivocado (en el chat o en el .mcp.json) y exponerla.
🎯 Consejo práctico
Regla de oro de los secretos: la clave de API solo entra en el .env — nunca en el chat, nunca en el .mcp.json, nunca confirmada con commit. El .gitignore garantiza que el .env no la subas. Trata una clave como el acceso a una tarjeta de crédito.
Conceptos clave
Reglas para todas las sesiones.
Solo aquí van los secretos.
Lo que no se despliega.
Registra herramientas.
🔌 MCP
Qué es
MCP (Model Context Protocol) es el protocolo que conecta el asistente con herramientas externas. Quien proporciona esas herramientas es un MCP server — un programita que expone un conjunto de acciones. Cada acción es una tool (herramienta): enviar correos, extraer datos de un sitio web, leer una base de datos. Una vez conectados, el asistente conoce todas las tools de ese server y decide cuál llamar.
No necesitas inventar servers desde cero: existe la descubrimiento de servers — directorios de MCP y repositorios públicos donde se encuentran servidores listos por categoría (scraping web, bases de datos, documentos, comunicación). Para instalar, suele bastar con pedirle al asistente que lo configure y pegar la clave en el .env y reiniciar.
GlosarioMCP y herramientas
- MCP (Model Context Protocol)
- El estándar que conecta el asistente con herramientas externas. Ej.: conectar el asistente a tu n8n.
- MCP server
- El programa que expone las acciones de un servicio. Ej.: un server de scraping web; un server de n8n.
- Tool (herramienta)
- Cada acción que ofrece el server. Ej.: «enviar correo electrónico», «buscar mensajes», «crear workflow».
- Descubrimiento de servers
- Encontrar servers listos en directorios/repositorios. Ej.: buscar "MCP server" + el nombre del servicio.
- Project-level vs global
- Dónde se configura el server. Por proyecto es lo recomendado (más seguro).
Por qué aprender
MCP es lo que transforma al asistente de «escritor de texto» en «hacedor de cosas en el mundo». Sin él, nada de enviar correos, rastrear la web o construir en n8n. Entender server × tool ayuda a pedir la herramienta adecuada y a recordar que cada server conectado consume contexto, así que desconecta los que no uses.
Conceptos clave
El idioma común.
Expone las acciones.
Una acción.
Más seguro que global.
🔗 n8n básico
Qué es
En n8n, el bloque básico es el nodo (node): una cajita que hace un trabajo. Todo flujo empieza con un trigger (disparador): el nodo que activa el flujo — por horario, al llegar un correo o cuando ocurre un evento. Toda la secuencia de nodos, desde el disparador hasta la acción final, es el workflow.
Para que un nodo acceda a una app (Gmail, Sheets…), necesita una credential (credencial): la autorización guardada en n8n. La forma más común de autorizar es el OAuth2 — un «inicio de sesión delegado» en el que accedes a tu cuenta de Google y concedes acceso, sin darle tu contraseña a n8n.
Diagrama ilustrativo — el disparador inicia, los nodos ejecutan, y la credencial (autorizada mediante OAuth2) es lo que le da al nodo acceso a la app externa.
GlosarioBloques de n8n
- Nodo (node)
- Una cajita que hace un trabajo. Ej.: un nodo que lee Gmail; otro que guarda en una hoja de cálculo.
- Trigger (disparador)
- El nodo que activa el flujo. Ej.: «cada 15 min» o «cuando llegue un correo electrónico».
- Workflow
- La secuencia completa de nodos. Ej.: activador → filtro → acción → guarda.
- Credential (credencial)
- La autorización guardada para acceder a una app. Ej.: la credencial de Gmail.
- OAuth2
- Inicio de sesión delegado: autorizas sin dar la contraseña. Ej.: «iniciar sesión con Google» y conceder acceso.
Por qué aprender
Estos cinco términos son el vocabulario mínimo para entender (y pedir) cualquier automatización. Hay un detalle que ahorra dolores de cabeza: el asistente construye los nodos, pero credenciales (OAuth2) tienes que configurarlo manualmente — es la parte que no hace por ti.
Conceptos clave
Haz un trabajo.
Activa el flujo.
Lo configuras manualmente.
Inicio de sesión sin dar la contraseña.
🤖 n8n con IA
Qué es
n8n tiene nodos que integran IA en el flujo. El AI agent node es el nodo que se convierte en un miniagente: recibe una instrucción (system prompt), puede usar herramientas y responde con razonamiento. El text classifier ("clasificador de texto") etiqueta una entrada en categorías —útil para enrutar antes de gastar en el agente caro (p. ej.: "¿esto es soporte técnico o no?").
Para lógica a medida existe el code node ("nodo de código"): un nodo donde se ejecuta un pequeño fragmento de código (que escribe el asistente) para transformar datos: extraer un nombre, armar un texto, activar una señal. Y para decisiones simples de sí o no está el IF node, que bifurca el flujo: si la condición es verdadera, sigue por un camino; si no, por otro.
GlosarioNodos de IA y lógica
- AI agent node
- Nodo que razona, usa herramientas y responde. Ej.: lee la pregunta, consulta la base y redacta la respuesta.
- Text classifier
- Clasifica la entrada en categorías para enrutarla. Ej.: «soporte» vs. «no relevante» — omite lo que no sea soporte.
- Code node
- Ejecuta un fragmento de código (escrito por el asistente) para transformar datos. Ej.: extraer el nombre de una suscripción.
- IF node
- Divide el flujo según una condición de sí/no. Ej.: «¿encontraste la política?» → si sí, redacta; si no, pide investigar.
Por qué aprender
Combinar estos nodos es el corazón de un agente útil: el classifier filtra desde el principio (ahorra), el IF decide los caminos, el code node ajusta los datos y el AI agent hace el trabajo de pensar. Saber el papel de cada uno te ayuda a entender lo que configuró el asistente y a pedir mejoras específicas.
✓ Buen diseño con estos nodos
- ✓Clasificar pronto para no activar al agente innecesariamente.
- ✓Usar IF para manejar caminos (encontró / no encontró).
- ✓Code node para extraer/transformar datos puntuales.
✗ Señales de problemas
- ✗Enviarle todo directamente al agente (caro y lento).
- ✗Olvidar el camino «no» del IF (el flujo muere en silencio).
- ✗Confiar en el "verde" sin revisar la salida real.
Conceptos clave
Piensa y usa herramientas.
Clasifica y enruta.
Transforma datos.
Divide el flujo.
📊 Datos
Qué es
Para que la IA responda con base en los tus documentos, necesitan convertirse en datos que se puedan consultar. El vector store ("almacén de vectores") es una base de datos especial que guarda el significado de los textos para buscar por sentido, no solo por palabra exacta. Ese "significado en números" son los embeddings: la representación numérica de un fragmento de texto.
Antes de almacenar, dos pasos preparan los documentos. El document loader ("cargador de documentos") lee el archivo y extrae el texto. El text splitter ("divisor de texto") divide ese texto en fragmentos del tamaño adecuado, porque buscar y recuperar funciona mejor con fragmentos que con un documento gigante completo.
GlosarioBloques de datos
- Vector store
- Base de datos que busca por significado, no por palabra exacta. Ej.: encuentra la política de garantía incluso sin la palabra «garantía».
- Embeddings
- El significado de un texto convertido en números. Ej.: los fragmentos parecidos quedan "cerca" en este espacio numérico.
- Document loader
- Lee el archivo y extrae el texto. Ej.: abrir un PDF de políticas y extraer el contenido.
- Text splitter
- Divide el texto en fragmentos que se puedan buscar. Ej.: dividir el PDF en fragmentos por sección.
Por qué aprender
Estos cuatro bloques son la base de RAG (que verás en el módulo 1.4): en vez de que la IA «adivine», consulta tus documentos y responde con base en ellos — y se niega a inventar cuando el dato no está ahí. Es lo que distingue a un agente confiable de uno que alucina.
La ventana de contexto se llenó de historial y la IA empezó a equivocarse más. ¿Cómo se llama este efecto?
Conceptos clave
Busca por significado.
Significado en números.
Lee el documento.
Divídelo en fragmentos.
📌 Resumen del módulo
/clear, /compact..env, .gitignore, .mcp.json, SKILL.md.Siguiente módulo:
1.4 — Glosario esencial (parte 2: agéntico, RAG, deploy, seguridad)