Flujos y programaciones

Los flujos son automatizaciones armadas en un constructor visual. Conectan modelos, agentes, contextos de conocimiento y de datos y sistemas externos en procesos que se ejecutan en el chat, por API o por programación.

Bloques

El constructor ofrece 13 tipos de bloque:

Bloque	Función
Entrada	Recibe el payload del origen permitido: API, chat u otro flujo.
Modelo de IA	Llama directamente a un modelo permitido, con prompt e instrucciones.
IA sobre filas	Aplica un paso de IA a muchas filas, en lotes de hasta 50 filas por llamada y hasta 8 llamadas simultáneas.
Agente	Envía el contexto del paso anterior a un agente publicado.
Decisión	Ramifica por campo y condición: igual, distinto, contiene, mayor que, menor que, existe o expresión.
Transformar	Mapea, normaliza o enriquece campos del payload.
Búsqueda en almacenamiento	Recupera fragmentos de contextos de conocimiento, con puntuación.
Consulta de datos	Lee filas de un contexto de datos con SQL.
Escritura de datos	Escribe filas en una tabla de un contexto de datos.
Cargar archivos	Carga hojas de cálculo o CSV desde una carpeta de Almacenamiento en una tabla.
Integración	Llama a una conexión HTTP registrada en Integraciones, con mapeo del cuerpo de la solicitud.
Subflujo	Ejecuta otro flujo publicado, con hasta 8 niveles de anidamiento.
Salida	Define la respuesta de la ejecución.

Los bloques de IA pueden devolver salida estructurada, validada por un JSON Schema con valores cerrados, lista para escribirse en una tabla. También pueden definir el esfuerzo de razonamiento del modelo.

Contrato

Cada flujo tiene un contrato:

Exposición: interna (solo como subflujo), API o chat.
Esquema de entrada y esquema de salida, en JSON Schema.
Orígenes permitidos y token del endpoint, cuando se expone por API. Consulte API de flujos.

Una entrada fuera del contrato hace fallar la ejecución y se registra automáticamente como irregularidad de calidad de datos.

Borrador, publicación y archivo

Un flujo nace como borrador, se publica para ejecutarse y puede archivarse. Solo los flujos publicados se ejecutan. Los flujos pueden exportarse e importarse en JSON (formato aptabit.flow), por ejemplo entre instalaciones.

Cómo se ejecuta un flujo

Origen	Cómo se dispara
Chat	Un flujo con exposición chat aparece como destino de conversación en el workspace.
API	Un flujo con exposición API recibe un `POST` en su propio endpoint, con token bearer.
Programación	Cualquier flujo publicado, a intervalo fijo.
Subflujo	Un flujo con exposición interna, llamado por el bloque subflujo de otro flujo.

La ejecución ocurre en el servicio de la API, de forma síncrona: quien llama recibe el resultado al final de la ejecución. Cada ejecución genera un registro con origen, estado (succeeded o failed), entrada, salida, mensaje de error y la traza de cada bloque: entradas, fuentes recuperadas con puntuación y decisiones tomadas. Una ejecución que falla conserva la traza de los bloques que llegaron a ejecutarse.

Las ejecuciones se consultan en Configuración > Logs, junto con las demás interacciones.

Programaciones

En Programaciones, un flujo publicado se ejecuta por sí solo:

Intervalo en minutos, horas o días, con un mínimo de 60 segundos.
Entrada JSON fija, enviada en cada ejecución.
Número máximo de ejecuciones, opcional.
Pausa y reanudación, con la próxima y la última ejecución visibles.

Las programaciones utilizan intervalos fijos; las expresiones de calendario, como "días hábiles a las 9 h", no están disponibles.

Plantillas de flujo

La pestaña Plantillas ofrece 30 plantillas de flujo en seis categorías:

Categoría	Ejemplos
Crédito y riesgo (8)	Análisis de crédito de personas y empresas, onboarding KYC, filtrado PLD/AML, filtrado de PEP y listas restrictivas.
Documentos y back office (7)	Extracción de facturas, extracción de contratos, conciliación bancaria, clasificación documental.
Atención (5)	Chat de atención con contexto de conocimiento, clasificación de tickets, resumen de atención.
Compliance y jurídico (4)	Revisión de cumplimiento, due diligence de proveedores, informe de auditoría, anonimización de datos (LGPD).
RR. HH. e interno (3)	Selección de currículos, asistente de políticas internas, onboarding de colaboradores.
Ventas y mercado (3)	Calificación de leads, propuesta comercial, análisis de la competencia.

Capacidades planificadas

Planificado: ejecución asíncrona de flujos largos con seguimiento del progreso, etapas de aprobación humana, webhooks de eventos de la plataforma con firma HMAC, versionado de flujos y entornos separados de desarrollo y producción. Estas capacidades no forman parte de la versión 3.7.