Un correo llega, un modelo extrae información y una API guarda un registro. En el diagrama parece sencillo. El trabajo de ingeniería está en definir qué significa cada paso y qué pasa cuando algo no sale como esperábamos.
Empieza por un proceso reconocible
Elige una tarea que el equipo pueda describir con ejemplos: registrar una solicitud, clasificar documentos o completar un expediente. Define dónde comienza, quién necesita el resultado y qué decisión sigue después.
Antes de elegir un modelo, reúne entradas representativas. Incluye mensajes incompletos, formatos distintos y casos que una persona tendría que aclarar. Esos ejemplos ayudan a acordar el alcance y a evaluar una primera versión.
Separa la extracción de la decisión
Extraer una fecha o un puesto de un correo no equivale a autorizar una acción. Define los campos esperados, cuáles son obligatorios y qué hacer cuando un dato falta. Una respuesta del modelo debe pasar por validaciones antes de convertirse en un registro de negocio.
Para un equipo de reclutamiento, por ejemplo, detectar una requisición puede ser una tarea distinta de aprobarla. Mantener esa separación permite decidir qué parte se automatiza y dónde participa una persona.
Diseña también el segundo intento
Una API puede responder tarde y un evento puede llegar más de una vez. El flujo debe poder identificar una solicitud ya procesada y evitar crear el mismo registro repetidamente. AWS recomienda operaciones idempotentes para manejar eventos duplicados en Lambda; es una referencia útil al diseñar los servicios que rodean al workflow.
Conviene definir estados visibles: recibido, pendiente de revisión, guardado o con error. Así, alguien puede entender qué ocurrió sin reconstruir toda la ejecución a partir de mensajes dispersos.
Evalúa el recorrido completo
Prueba desde la entrada hasta el sistema de destino. Revisa qué se extrajo, qué validaciones se aplicaron, qué se guardó y cómo se recupera un fallo. Un prompt que funciona con un ejemplo todavía no demuestra que la integración esté lista.
Una primera entrega útil tiene un alcance acotado, ejemplos para comprobarla y una persona responsable de revisar los casos pendientes. Con esa base se puede medir el proceso real y decidir qué automatizar después.