Plantillas

​

Resumen

Una Plantilla (Template) es la estructura reutilizable de un Pipeline: el objetivo que persigue, las entradas que consume y el grafo dirigido de nodos de fuente, transformación y salida que convierten los datos en derivaciones. Las Plantillas se crean una vez y se ejecutan muchas veces. Cada ejecución es una nueva corrida de la misma Plantilla contra un conjunto específico de entradas; consulta Ejecuciones. Por ejemplo, una Plantilla podría tomar exportaciones semanales del MES como entrada, calcular los tiempos de ciclo por estación y depositarlos como parámetros del modelo de simulación, y puedes volver a ejecutarla cada semana cuando lleguen datos nuevos. Las Plantillas y las ejecuciones son dos vistas del mismo Pipeline. La Plantilla es el contrato: la estructura, el objetivo, las definiciones de Compuertas. Una Ejecución (Run) es donde aterrizan los valores concretos contra ese contrato.

​

Cómo abrir una Plantilla

Haz clic en el icono Data en la barra lateral izquierda para abrir el espacio de trabajo de Pipelines. El lienzo muestra el Pipeline seleccionado en ese momento. Usa el selector de modo en la barra superior para alternar entre editar la Plantilla y ver una ejecución específica; por defecto muestra Template o una fecha de ejecución (p. ej. Apr 24, 2026). Al seleccionar Template en el menú desplegable, el lienzo entra en modo de edición de Plantilla. Usa el selector de Pipeline a la izquierda del selector de modo para alternar entre Pipelines o crear uno nuevo (+ Create new pipeline).

​

El panel de la Plantilla

Cuando el lienzo está en modo Plantilla, el panel lateral izquierdo muestra los metadatos editables de la Plantilla:

• Goal — un párrafo corto que indica qué busca derivar el Pipeline. Esto no es solo una etiqueta: Dexter usa activamente el objetivo en tiempo de ejecución para acotar la exploración y fundamentar las decisiones de extracción, por lo que un objetivo claro orienta tus ejecuciones hacia los parámetros que realmente puedes extraer de las entradas.
• Inputs — las Fuentes de datos (Data Sources) que consume la Plantilla. Cada fila muestra el nombre de la fuente y un control de eliminación que aparece al pasar el cursor. Haz clic en + Add input para adjuntar una nueva fuente: elige Upload a file (CSV, XLSX, PDF u otro archivo que el agente deba inspeccionar) o Connect an integration (p. ej. Salesforce, SAP). Las integraciones conectadas se gestionan a través de tu equipo de ProDex; consulta Fuentes de datos.

​

El grafo

Una Plantilla es un grafo dirigido con tres tipos de nodos, conectados por aristas que fluyen desde las fuentes a través de las transformaciones hasta las salidas. Fuente (Source) — el punto de entrada. Hace referencia a un archivo de entrada o a una fuente conectada y le da instrucciones a Dexter sobre cómo leerla. Los nodos Fuente siempre deben llevar una Compuerta (Gate) que verifique la forma de la entrada (columnas presentes, valores en rango) antes de que continúe el trabajo aguas abajo; Dexter agrega una automáticamente al construir un Pipeline. Transformación — un paso intermedio. Filtros, agregaciones, conversiones de unidades, joins. Cada transformación tiene una descripción que combina instrucciones narrativas y (típicamente) un fragmento de código Python entre cercas que muestra cómo se realizó la transformación. Las Compuertas son opcionales en las transformaciones: agrega una cuando la salida de la transformación impulse un valor aguas abajo de alto impacto. Salida — el punto de salida. Los nodos de salida recogen los resultados derivados. Las Compuertas no se permiten en las salidas; para cuando un valor llega a la salida, la palanca correctiva está aguas arriba. Cada nodo de salida es de uno de dos tipos:

• platform — la salida alimenta valores de vuelta a otra página de la app de ProDex (Modelador, Planificación, BOMs, Configurador de BOMs, Hallazgos). El detalle de la ejecución muestra un botón Open in [app] para navegar a donde aterriza el valor.
• report — la salida es un archivo descargable tangible. El nodo de salida lleva un format requerido (p. ej. xlsx, pdf), y una vez que la ejecución se completa, el detalle de la ejecución muestra un enlace de descarga al archivo producido.

​

Cómo editar un nodo

Haz clic en cualquier nodo del lienzo para abrir su editor. Nodos Fuente

• Name — etiqueta corta que aparece en el lienzo y en el historial de ejecuciones.
• Details — tipo de fuente (archivo subido vs. integración conectada) y formato (CSV, XLSX, nombre de integración, etc.).
• Notes — contexto en texto libre al que Dexter y futuros revisores pueden referirse; útil para registrar particularidades de los datos fuente.
• Gate — Nombre, Descripción e Instrucciones que listan las verificaciones que Dexter debe realizar. Las instrucciones se renderizan como Markdown en el panel de chat, por lo que formatearlas como lista funciona bien.
• Example data — una pequeña vista previa de la entrada vinculada con controles de copiar / descargar / pantalla completa para que puedas validar qué está fluyendo.

Nodos de transformación

• Description — la narrativa que explica qué hace este paso. El bloque de código Python entre cercas al final es parte del mismo campo de descripción; la interfaz separa visualmente la prosa y el fragmento, pero al editar uno se edita el mismo campo. Los bloques de código tienen controles de descarga y copia.
• Gate (opcional) — misma estructura de Nombre / Descripción / Instrucciones que una Compuerta de fuente. Agrega una cuando la salida de la transformación impulse un valor aguas abajo de alto impacto.

Nodos de salida

• Name y descripción narrativa — qué representa esta salida.
• Píldora Output type — platform o report (consulta “El grafo” arriba para ver qué hace cada uno).
• Example value — una muestra del valor que producirá este nodo, para que los revisores vean qué esperar antes de ejecutar.
• Derivations — el linaje completo del valor producido; haz clic en el encabezado del nodo para expandir.

​

Cómo ejecutar una Plantilla

Haz clic en el botón Run Pipeline en la barra superior para iniciar una nueva ejecución contra las entradas vinculadas a la Plantilla. Mientras una ejecución está en curso:

• Dexter se detiene en cada Compuerta y pide confirmación en el panel de chat. Confirm para desbloquear los nodos aguas abajo; Reject si algo está mal (forma incorrecta, valores incorrectos, falta de contexto). Una Compuerta rechazada bloquea todos los nodos aguas abajo: arregla la entrada o la transformación, luego vuelve a evaluar la Compuerta o vuelve a ejecutar el Pipeline. Si una Compuerta permanece rechazada, la ejecución finaliza como completed_partial con los valores alcanzables que sí se produjeron.
• El panel Run Information a la izquierda rastrea el progreso: entradas vinculadas, Compuertas resueltas, resultados producidos, última actualización.

El resultado es una Ejecución: un registro de cada entrada consumida, cada valor producido y cada confirmación de Compuerta — un rastro de auditoría que puedes revisar y comparar contra ejecuciones futuras. Consulta Ejecuciones para conocer la superficie de detalle de ejecución y cómo se corrigen las derivaciones.

​

Volver a ejecutar

Las Plantillas están diseñadas para ejecutarse muchas veces. Cuando lleguen datos nuevos, sube los nuevos archivos (o refresca la fuente conectada) y lanza otra ejecución desde el mismo selector de Pipeline: la Plantilla no cambia, solo las entradas. Las ejecuciones pasadas siguen accesibles desde el selector de modo para comparación lado a lado.

​

Qué sigue

• Ejecuciones — revisar qué produjo una ejecución y cómo corregir valores
• Compuertas — el flujo de confirmación en detalle (estados, qué hacer cuando rechazas, cuándo añadir Compuertas a las transformaciones)
• Fuentes de datos — el catálogo de integraciones y cómo se configuran las conexiones
• Hallazgos — convierte fuentes o salidas de Pipeline en paneles de gráficos a los que tu equipo pueda navegar