> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prodexlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plantillas

> Las plantillas de Pipeline son el DAG reutilizable que creas una vez y ejecutas muchas veces. Cada plantilla tiene un objetivo, entradas y un grafo de nodos de fuente / transformación / salida.

## 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](/es/product/runs).

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](/es/product/data-sources).

## 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)](/es/product/gates) 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.

<Tip>
  **No quites la Compuerta de fuente añadida automáticamente.** Los errores de forma de la entrada que se cuelan se acumulan silenciosamente en cada paso aguas abajo: para cuando un número incorrecto llega a una salida, el error original de la fuente ya está varias transformaciones atrás.
</Tip>

**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.

<Note>
  **Cada nodo de salida produce un valor.** Si tu Pipeline deriva tiempos de ciclo para tres estaciones, son tres nodos de salida, no uno, ni una sola salida con tres valores empacados dentro.
</Note>

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](/es/product/runs) 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](/es/product/runs): revisar qué produjo una ejecución y cómo corregir valores
* [Compuertas](/es/product/gates): el flujo de confirmación en detalle (estados, qué hacer cuando rechazas, cuándo añadir Compuertas a las transformaciones)
* [Fuentes de datos](/es/product/data-sources): el catálogo de integraciones y cómo se configuran las conexiones
* [Hallazgos](/es/product/insights): convierte fuentes o salidas de Pipeline en paneles de gráficos a los que tu equipo pueda navegar