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

# Workflows

> Diseña conversaciones estructuradas en múltiples pasos que guíen a tu agente a través de interacciones definidas, etapa por etapa.

Los **Workflows** te permiten diseñar conversaciones estructuradas para tu agente de IA. En lugar de una conversación abierta, puedes definir una secuencia de **etapas** y **transiciones** que guíen al agente a través de un camino predecible y controlado.

Esto es ideal para calificación de ventas, flujos de onboarding, agendado de citas o cualquier interacción donde la conversación deba seguir una secuencia definida.

<Note>
  Workflows es una función en **Beta**. Está en desarrollo activo y algunas capacidades pueden cambiar.
</Note>

## Conceptos clave

### Etapas

Una etapa es un paso en la conversación. Cada etapa tiene:

* Un **nombre** que identifica el paso (ej. `Saludo`, `Calificación`, `Cierre`)
* Un **identificador** — generado automáticamente a partir del nombre de la etapa (minúsculas, sin acentos, guiones bajos en lugar de espacios). Los identificadores deben ser únicos dentro del workflow.
* **Instrucciones** que le dicen al agente qué hacer o decir en esa etapa
* Un **objetivo** — qué necesita lograr el agente antes de avanzar

### Transiciones

Una transición es la regla que mueve la conversación de una etapa a la siguiente:

* La **etapa origen** (donde estamos)
* La **etapa destino** (hacia dónde ir)
* La **condición** que activa la transición

<Warning>
  Toda transición **debe** tener una condición. El workflow no se puede guardar si alguna transición tiene la condición vacía.
</Warning>

### Canales

Cada **workflow** se asigna a uno o más canales. Un canal solo puede tener **un workflow a la vez**.

## El editor de Workflows

El editor de workflows es un lienzo visual donde puedes arrastrar, soltar y conectar etapas. La configuración de cada etapa — y sus transiciones salientes — se gestiona desde un único panel lateral.

### Panel de configuración de etapa

Haz clic en cualquier etapa del lienzo para abrir el panel de **Configuración de Etapa** a la derecha. El panel está organizado en secciones colapsables tipo acordeón:

| Sección                        | Qué contiene                                                                                        |
| ------------------------------ | --------------------------------------------------------------------------------------------------- |
| **Configuración de Etapa**     | Nombre de la etapa (e identificador auto-generado) e instrucciones del agente para este paso.       |
| **Fragmentos de conocimiento** | Texto de contexto o conocimiento que el agente puede consultar durante esta etapa.                  |
| **Búsqueda de temas**          | Interruptor para habilitar la búsqueda en la base de conocimiento, con filtrado opcional por temas. |
| **Transiciones**               | Todas las transiciones salientes de esta etapa, cada una con su destino y condición.                |

### Guardar cambios de etapa

En la parte inferior del panel de Configuración de Etapa encontrarás el botón **Guardar Etapa**. Este botón está **deshabilitado** (en gris) cuando la configuración actual de la etapa y sus transiciones son idénticas a los valores que tenían cuando se abrió el panel. Se **habilita** en cuanto modificas cualquier campo — nombre de la etapa, instrucciones, fragmentos de conocimiento, configuración de temas o condiciones de transición.

<Tip>
  Si realizas cambios y luego los deshaces para que la etapa quede igual que al inicio, el botón se deshabilitará automáticamente de nuevo. Esto te ayuda a evitar guardados innecesarios.
</Tip>

### Gestión de transiciones

Las transiciones se configuran **dentro del panel de configuración de la etapa origen**, en la sección **Transiciones**:

1. **Crear una transición**: dibuja una conexión de una etapa a otra en el lienzo. Al conectar dos etapas, el panel de configuración de la etapa origen se abre automáticamente para que puedas definir la condición de inmediato.
2. **Editar una condición**: abre la configuración de la etapa origen y desplázate hasta la sección de Transiciones. Cada transición muestra su etapa destino y un campo editable para la condición.
3. **Eliminar una transición**: haz clic en el botón de eliminar junto a ella en la lista de transiciones, o selecciona la arista en el lienzo y presiona `Delete` / `Backspace`.

<Warning>
  Las transiciones con **condiciones vacías** bloquearán el guardado del workflow. Asegúrate de que cada transición tenga una condición válida antes de guardar.
</Warning>

### Controles del lienzo

* **Acercar/alejar** con la rueda del ratón o los controles en la esquina inferior izquierda del lienzo.
* **Desplazar** haciendo clic y arrastrando en un área vacía del lienzo.
* **Seleccionar una etapa** haciendo clic en ella. Las etapas seleccionadas se resaltan.
* **Eliminar una etapa** seleccionándola y presionando `Delete` / `Backspace`, o usando la opción de eliminar en el menú contextual de la etapa.
* **Selección múltiple** manteniendo `Shift` y haciendo clic, o arrastrando un recuadro de selección.