Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://semantiks.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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.
Workflows es una función en Beta. Está en desarrollo activo y algunas capacidades pueden cambiar.

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
Toda transición debe tener una condición. El workflow no se puede guardar si alguna transición tiene la condición vacía.

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ónQué contiene
Configuración de EtapaNombre de la etapa (e identificador auto-generado) e instrucciones del agente para este paso.
Fragmentos de conocimientoTexto de contexto o conocimiento que el agente puede consultar durante esta etapa.
Búsqueda de temasInterruptor para habilitar la búsqueda en la base de conocimiento, con filtrado opcional por temas.
TransicionesTodas 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.
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.

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

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.