Extract Key

Bienvenido al componente Extract Key dentro de Nappai. Piensa en él como un “filtro inteligente” que busca y recupera una pieza de información específica dentro de un paquete de datos que le envíes. En lugar de revisar manualmente grandes cantidades de información, este componente se encarga de encontrar exactamente lo que necesitas (por ejemplo, un ID, un nombre o una fecha) y te lo entrega listo para usar en el siguiente paso de tu flujo.

¿Cómo funciona?

Cuando conectas este nodo a tu flujo, el componente recibe los datos que le proporcionas y busca en su interior la etiqueta exacta que indiques. Una vez la encuentra, extrae su valor y lo prepara para que puedas usarlo en las siguientes conexiones.

Si el sistema no encuentra la etiqueta que buscabas, no se detiene ni genera un fallo crítico: en su lugar, te devuelve un mensaje claro que indica el problema, permitiéndote revisar y corregir tu flujo sin perder el control. Si le proporcionas varios elementos a la vez (una lista), procesa cada uno de forma individual y te devuelve los resultados correspondientes.

Entradas

Campos de Entrada

Data Input: El paquete de datos (un solo objeto o una lista de objetos) del cual deseas extraer la información. Asegúrate de que este campo reciba datos estructurados para que la búsqueda funcione correctamente.
Key to Extract: La etiqueta o nombre exacto de la información que buscas dentro del paquete de datos. Puedes escribirlo manualmente o aprovechar la función de arrastrar y soltar para conectar variables desde otros componentes y crear combinaciones dinámicas.

Salidas

El componente devuelve el resultado de la búsqueda en el campo Extracted Data. Este valor está listo para ser conectado a otros nodos (como formularios, bases de datos o respuestas de IA). En caso de que la búsqueda falle, en lugar de detener tu flujo, recibirás un objeto que contiene un campo "error" con una explicación clara, lo que te permite monitorear y ajustar tu automatización con tranquilidad.

Ejemplo de Respuesta JSONjson

{ “data”: { “user_id”: “847291”, “email”: “cliente@ejemplo.com”, “estado”: “activo” } } Este ejemplo muestra cómo el componente estructura la salida. Los valores extraídos se empaquetan dentro de data, listos para ser mapeados en los siguientes pasos de tu flujo.

Conectividad

Este componente actúa como un puente de extracción. Lógicamente, se conecta después de nodos que obtienen o generan datos (como solicitudes a APIs, consultas a bases de datos, web scraping o respuestas de asistentes de IA). Se conecta antes de nodos que necesitan procesar o usar esa información específica (como formateadores de texto, routers condicionales, actualizaciones de registros o prompts para IA). Su propósito es mantener el flujo limpio, entregando solo la pieza de datos necesaria para el siguiente paso.

Ejemplo de Uso

Imagina que estás automatizando la atención al cliente. Un nodo de “Lectura de API” devuelve un paquete con datos del usuario (nombre, email, ID, historial, etc.). Conectas ese paquete al Data Input del Extract Key. En el campo Key to Extract, escribes user_id. El componente busca ese campo dentro del paquete, extrae el valor 847291 y lo envía por Extracted Data a un nodo de “Actualización de CRM”. El resultado: un flujo limpio que solo transfiere el identificador necesario, evitando errores por datos sobrantes.

Notas Importantes

🟡 Manejo de claves no encontradas 🟢 Si la clave especificada no existe en un objeto de datos, el componente devuelve un objeto con un campo de “error” describiendo el problema en lugar del valor extraído. 🟡 Ignorar elementos ajenos a datos en listas 🟡 Al proporcionar una lista, solo se procesarán los elementos que son objetos de datos. Otros tipos se omiten silenciosamente, lo que podría dejar algunas entradas sin salida. 🟢 Proporcionar objetos de datos como entrada 🟢 El componente espera que la primera entrada sea un objeto de datos o una lista de ellos; pasar otros tipos generará una salida de error. 🟢 La clave debe ser una cadena de texto 🟢 La segunda entrada, la clave a extraer, debe ser un texto. Dejarlo vacío o usar un tipo diferente hará que la extracción falle. 🟢 Usar claves exactas y sensibles a mayúsculas 🟢 La búsqueda de claves distingue entre mayúsculas y minúsculas. Verifica siempre la ortografía para evitar errores o pérdida de datos. 🟢 Revisar campos de error en la salida 🟡 Tras la extracción, inspecciona el objeto devuelto buscando un campo “error” para manejar casos donde la clave estaba ausente o la entrada era inválida. 🟢 La entrada en lista genera una salida en lista 🟢 Cuando se ingresa una lista de objetos de datos, el componente devuelve una lista donde cada elemento contiene solo la clave y el valor extraído. 🟢 Las claves ausentes se omiten en la lista 🟡 Si un objeto de datos en una lista no tiene la clave especificada, se omite del resultado en lugar de generar un error individual.

Consejos y Mejores Prácticas

Verifica siempre que el texto en Key to Extract coincida exactamente con el nombre del campo en tus datos (respeta mayúsculas y minúsculas).
Aprovecha la función de arrastrar y soltar en Key to Extract cuando necesites construir claves dinámicas; esto evita errores manuales y acelera tu flujo.
Si tu flujo trabaja con muchos registros, espera una respuesta en formato de lista; el componente mantendrá la estructura para que puedas conectar todo junto.
Revisa los mensajes de error en la salida solo si el flujo se detiene o no muestra el resultado esperado; de lo contrario, ignora el campo de “error” ya que indica que la operación fue exitosa.

Consideraciones de Seguridad

Este componente opera de forma local dentro del grafo de Nappai y no transmite información a servicios externos por sí mismo. Sin embargo, al extraer y reenviar datos, asegúrate de que los campos que compartas cumplan con las políticas de privacidad de tu organización. Revisa siempre que la clave solicitada no contenga información sensible no autorizada antes de conectarla a bases de datos o sistemas de terceros.