# Flujos de trabajo

> Automatice flujos de trabajo de IA de varios pasos que encadenan habilidades, disparadores y acciones.

Source: https://docs.graph8.com/es/ai-features/workflows/

Los Workflows le permiten automatizar procesos de varios pasos encadenando disparadores, habilidades y acciones. Configúrelos una vez y se ejecutarán de forma automática.

## Cómo funciona

1. Vaya a **Agents → Workflows**
2. Haga clic en **Create Workflow**
3. Defina un disparador (por ejemplo, contacto nuevo agregado, formulario enviado, cambio de etapa en una oportunidad)
4. Agregue pasos: cada paso utiliza una habilidad o ejecuta una acción
5. Active el workflow

## Estructura del workflow

Cada workflow sigue el mismo patrón: un **disparador** lo inicia, los **pasos** procesan los datos y las **acciones** producen un resultado.

| Componente | Función | Ejemplos |
|-----------|------|----------|
| **Disparador** | Inicia el workflow cuando ocurre un evento | Nuevo visitante en el sitio web, formulario enviado, nueva señal de intención, webhook, ejecución manual |
| **Pasos** | Procesan, transforman o toman decisiones sobre los datos | Ejecutar una acción de IA, verificar una condición, iterar sobre una lista, esperar aprobación humana |
| **Acciones** | Producen un resultado o efecto secundario | Enviar email, agregar a lista, agregar a secuencia, enviar DM en Slack, transferir a un agente |

El editor visual le permite conectar estos elementos como nodos en un lienzo. Arrastre nodos desde la paleta, conéctelos con aristas y configure cada uno en el panel lateral.

### Modos del editor

Puede crear workflows de tres maneras:

- **Visual**: lienzo de nodos con arrastrar y soltar (recomendado para lógica compleja)
- **Simple**: lista lineal de pasos (ideal para cadenas sencillas)
- **Código**: editor JSON sin formato (para usuarios avanzados)

Al cambiar entre modos, el workflow se convierte automáticamente.

### Nodos disponibles

| Categoría | Nodos |
|----------|-------|
| **Core** | Start, End, Trigger, Webhook |
| **Acciones** | Action (LLM / API / Script), Agent, Built-in Tool (búsqueda web, búsqueda en base de conocimiento) |
| **Control de flujo** | If/Else (ramificación condicional), Loop (for-each, while, times), Human Approval |
| **Datos** | Transform (map, filter, extract, format), Set Variable |
| **Multiagente** | Handoff (transferencia a otro agente con contexto) |
| **Integraciones** | Add to List, Add to Sequence, Send Email, Send Slack Notification, Send Roam Notification |

## Acciones del workflow

Las acciones son los nodos que realizan el trabajo. Cada acción tiene un **mapeo de entrada** que extrae datos de pasos anteriores mediante variables.

### Variables

Use `${input.field_name}` para hacer referencia a las entradas del workflow y `${step1.result}` para hacer referencia al resultado de pasos anteriores. Las variables están disponibles en cualquier campo de texto dentro de la configuración de un nodo.

Por ejemplo, un paso "Draft Outreach Email" podría mapear:
- `company_info` → `${step1.result}`
- `recipient_name` → `${input.contact_name}`

### Acciones de integración

| Acción | Qué hace |
|--------|-------------|
| **Send Email** | Envía o redacta un email a través de un buzón conectado. Configure el destinatario, asunto, contenido y CC/BCC |
| **Add to List** | Agrega un contacto a una lista de CDP mapeando los campos de entrada |
| **Add to Sequence** | Inscribe un contacto en una secuencia con asociación opcional a una lista |
| **Send Slack Notification** | Envía un mensaje a un canal de Slack o un DM a un usuario. Elija el modo **channel** o **dm**, seleccione el destino y redacte el mensaje con variables |
| **Send Roam Notification** | Envía una notificación a un miembro del equipo a través de ro.am |
| **Round-Robin Assignment** | Distribuye el contacto actual del workflow entre un grupo de representantes (gerentes de ventas, AEs, SDRs). Configure el grupo, la ponderación y las reglas de omisión en el panel del nodo |
| **Visitor Enrichment** | Enriquece a un visitante o contacto con varios campos en una sola llamada. Seleccione los campos que desea completar (email de trabajo, teléfono, cargo, tamaño de empresa, etc.); el nodo los devuelve todos juntos para que los pasos posteriores puedan ramificarse según cualquiera de ellos |

### Manejo de errores

Cada nodo de acción tiene una estrategia de error:
- **Stop**: detiene el workflow ante un fallo
- **Continue**: omite el paso fallido y continúa
- **Retry**: reintenta con cantidad de intentos, demora y retroceso configurables (fijo o exponencial)
- **Fallback**: redirige a un nodo distinto ante un fallo

## Uso de habilidades en workflows

Las habilidades son definiciones reutilizables de acciones de IA con un prompt fijo, un esquema de entrada y un formato de salida. Dentro de un workflow, las habilidades aparecen como nodos de **Action** con `runtime_type: llm`.

Para usar una habilidad en un workflow:

1. Agregue un nodo de **Action** al lienzo
2. Seleccione una habilidad existente desde el selector de acciones, o cree una a partir de una plantilla
3. Mapee las entradas de la habilidad con datos del disparador o de pasos anteriores
4. El resultado de la habilidad queda disponible para los nodos posteriores como `${stepN.result}`

graph8 incluye plantillas de habilidades prediseñadas en distintas categorías: Ventas (calificación de leads, investigación de empresa), Marketing (resumen de contenido, generación de publicaciones en redes sociales), Soporte (análisis de tickets, búsqueda en base de conocimiento) e Investigación (análisis competitivo, preparación de reuniones).

## Plantillas

Haga clic en **Use Template** al crear un workflow para comenzar desde un ejemplo preconfigurado:

| Plantilla | Categoría | Qué hace |
|----------|----------|-------------|
| **Lead Qualification** | Ventas | Investiga la empresa → califica el lead → redacta un email de prospección |
| **Content to Social Media** | Marketing | Resume contenido → genera una publicación en LinkedIn → genera un hilo en Twitter |
| **Contact Data Enrichment** | Procesamiento de datos | Enriquece datos de empresa → valida email → genera resumen de contacto |
| **Customer Support** | Soporte | Analiza el ticket → busca en la base de conocimiento → redacta una respuesta |
| **Meeting Preparation** | Productividad | Investiga a los asistentes → genera la agenda → prepara puntos de discusión |
| **Competitive Intelligence** | Investigación | Investiga al competidor → analiza funcionalidades → genera un informe comparativo |

Las plantillas son puntos de partida: personalice los disparadores, agregue pasos o reemplace acciones para adaptarlas a su proceso.

## Ejecución y monitoreo

Tras activar un workflow, puede monitorear las ejecuciones desde la página de detalle del workflow:

- Cada ejecución muestra su estado (**running**, **completed**, **failed**, **paused**)
- Haga clic en una ejecución para ver los resultados por nodo, la duración y los posibles errores
- Los workflows con un nodo de **Human Approval** quedan en pausa hasta que alguien apruebe o rechace

## Buenas prácticas

- Comience con una plantilla y modifíquela en lugar de construir desde cero
- Use nodos **If/Else** para manejar casos excepcionales: por ejemplo, omitir la prospección si la puntuación del lead es demasiado baja
- Configure **stop on failure** en workflows críticos donde una ejecución parcial pueda generar problemas
- Agregue un nodo de **Human Approval** antes de acciones irreversibles como enviar emails o inscribir contactos en secuencias
- Mantenga los workflows enfocados: un workflow por resultado. Encadene workflows mediante webhooks para pipelines complejos

> **Tip:**
> Pruebe los workflows con el diálogo **Test Execution** antes de activarlos. Ejecuta el workflow con datos de muestra y muestra los resultados de cada paso sin disparar acciones reales.

## Relacionado

- [Skills →](https://docs.graph8.com/ai-features/skills/): los bloques fundamentales que utilizan los workflows
- [Agents →](https://docs.graph8.com/ai-features/overview/): agentes de IA que ejecutan los pasos del workflow