El prompt es el corazón de tu agente; define el comportamiento exacto del Nodo Cortex. Se escribe en el panel derecho, se puede expandir a un editor completo, y cuenta con un asistente de IA que te ayuda a generar una primera versión estructurada.
📍 ¿Dónde se escribe?
Para acceder al campo de instrucciones, la ruta es:
Canvas → Seleccionar Nodo Cortex → Panel derecho → Pestaña (Tab) General → Objetivo de la conversación.
📝 El editor de Prompts
Tienes dos formas de trabajar con el texto de tus instrucciones, dependiendo de qué tan largo sea tu prompt.
1. Textarea inline (Panel lateral)
El campo directamente en el panel se puede agrandar y achicar verticalmente arrastrando el handle (control) de la esquina inferior derecha.
Altura mínima: Aproximadamente 6 líneas.
Altura máxima: Aproximadamente 20 líneas (a partir de ahí, se habilita el scroll interno).
Memoria: El tamaño que elijas se recuerda de forma independiente para cada nodo.
2. Modal de edición (Pantalla completa)
Como los prompts suelen ser largos, el panel lateral puede quedar incómodo. El modal abre un editor grande y enfocado, que ocupa al menos el 70% del alto de la pantalla. Incluye resaltado de sintaxis para variables, contador de caracteres al pie y guardado automático como borrador cada 30 segundos para evitar pérdida de datos.
Acción | Cómo realizarla |
Abrir el modal | Clic en el ícono de expandir (esquina superior derecha del campo), o |
Buscar y reemplazar |
|
Guardar y cerrar |
|
Cerrar sin guardar | Tecla |
⚡ Insertar campos y herramientas
Dentro del prompt, cuentas con dos atajos de teclado muy útiles que despliegan menús filtrables (puedes seguir escribiendo para reducir la lista). En runtime, estas referencias se resuelven automáticamente con el valor capturado o la instrucción de la herramienta.
Atajo | Qué despliega | Qué inserta en el texto |
| Los campos de guardado configurados en el nodo. | Una referencia al campo, por ejemplo: |
| Las herramientas (Tools) conectadas al nodo. | Una referencia a la herramienta, por ejemplo: |
🏗️ Cómo estructurar el prompt
Un prompt desordenado confunde a la IA. La estructura recomendada se divide en siete secciones claras:
Rol y objetivo: Qué es el nodo y para qué existe.
Contexto: Información clave del negocio, industria, público y tono de marca.
Capacidades y herramientas: Qué puede hacer y con qué cuenta para lograrlo.
Flujo de conversación: Los pasos ordenados a seguir (si aplica) con sus respectivas condiciones.
Reglas y restricciones: Qué NO hacer, límites operativos y políticas estrictas.
Ejemplos: Casos concretos de un mensaje del cliente y la respuesta exacta esperada.
Formato de respuesta: Cómo debe estructurar visualmente cada mensaje.
🏆 Las 3 reglas de oro para un buen prompt
Estas tres reglas son las que más impacto tienen sobre el resultado final:
Instrucciones concretas y verificables: "Respondé en máximo 3 oraciones" se puede verificar por el sistema; "Sé cordial" es demasiado subjetivo.
Al menos dos ejemplos: Incluye ejemplos claros para cada comportamiento crítico o salida.
Instrucciones positivas: "Hacé una pregunta por mensaje" funciona mucho mejor para el LLM que "No hagas más de una pregunta por mensaje".
💡 Tip de Arquitectura: Si tu prompt supera las 400 líneas, es muy probable que ese nodo esté intentando hacer demasiadas cosas a la vez. En ese caso, te conviene dividirlo en varios nodos especializados.
⚠️ Advertencia de Configuración Global: El tono, el idioma y las reglas que aplican a todo el flujo deben ir en la Configuración Global, NO en el prompt de cada nodo. Repetirlos aquí consume tokens innecesarios en todos los turnos y te obliga a replicar cada cambio manualmente.
🪄 El Asistente de IA
Si no sabes por dónde empezar, el Asistente de IA toma una descripción simple en lenguaje natural de lo que necesitas y genera un prompt estructurado siguiendo todas las buenas prácticas.
Cómo se usa (Paso a paso)
Haz clic en el botón Asistente IA (accesible desde el campo de instrucciones).
Escribe en lenguaje natural qué debe hacer el nodo (Ej. "Que atienda clientes de soporte técnico y escale con un humano si no puede resolver").
Revisa el prompt generado. Lo nuevo aparecerá marcado visualmente para distinguirlo de lo que ya estaba escrito.
Acepta, edita a mano, revierte o regenera el texto dándole instrucciones adicionales al asistente.
¿Qué tiene en cuenta el Asistente AI ?
El asistente es inteligente y usa el contexto de tu nodo para generar instrucciones precisas:
Herramientas conectadas: Incluye instrucciones sobre cuándo y cómo usarlas, considerando sus inputs y formatos.
Campos de guardado: Agrega instrucciones automáticas para recolectar esos datos.
Bases de conocimiento: Ajusta el prompt para que el nodo las consulte cuando corresponda.
Guardrails (Barreras de seguridad): Genera automáticamente restricciones operativas, temas prohibidos y directrices para evitar alucinaciones. Puedes indicarle temas que el nodo debe declinar, y el Asistente AI los incluirá como reglas explícitas.
¡Conviértete en un arquitecto de IA! 🚀
Escribir buenos prompts es el superpoder definitivo en Cortex. Utiliza el editor a pantalla completa, apóyate en el Asistente AI para estructurar tus ideas y sigue las reglas de oro para lograr que tus agentes respondan siempre con precisión y naturalidad. ✅