Endpoint API de Preguntas y Respuestas sobre Documentos con RAG Vectorial de PDF - Flujo de trabajo de n8n

• Desarrolladores de IA e ingenieros de backend que necesiten un microservicio RAG (Generación Aumentada por Recuperación) personalizado.


• Integradores de sistemas que crean APIs de alto rendimiento con n8n.


• Usuarios que buscan aprovechar el nodo Vectorial de PDF de n8n para consultas contextuales de documentos.


• Aquellos que buscan plantillas avanzadas de n8n para servicios web personalizados.

Este flujo de trabajo especializado de n8n transforma una simple solicitud de procesamiento de documentos en un sofisticado servicio API consciente del contexto. Aborda el desafío de proporcionar respuestas instantáneas y verificables basadas en el contenido de un documento específico, como PDFs o artículos web. Al utilizar el potente nodo Vectorial de PDF de n8n, el flujo de trabajo analiza, vectoriza y consulta eficientemente el documento proporcionado, imitando la lógica de una base de conocimiento personalizada. La arquitectura está diseñada para ofrecer fiabilidad, comenzando con un sólido paso de validación y terminando con una respuesta JSON estandarizada, lo que garantiza que esta plantilla de n8n esté lista para producción. Todo este proceso es orquestado por n8n, demostrando su capacidad mucho más allá de la simple automatización de tareas, permitiendo a los usuarios desplegar rápidamente servicios web impulsados por IA.

Todo el proceso se inicia mediante una llamada API externa utilizando el disparador (trigger) Webhook de n8n. Este flujo de trabajo de n8n opera de manera clara y lineal:

1. Disparador API: El proceso comienza cuando el disparador Webhook de n8n recibe una solicitud POST en el endpoint configurado /doc-qa. La solicitud debe contener una URL de documento y la pregunta del usuario.


2. Validación de Solicitud: El primer nodo Code de n8n, 'Validate Request' (Validar Solicitud), analiza el cuerpo JSON entrante. Se asegura de que la question (pregunta) y un identificador de documento (documentUrl o documentId) estén presentes, generando un sessionId único y estableciendo una bandera booleana valid (válido).


3. Comprobación Condicional: El nodo n8n 'Valid Request?' (¿Solicitud Válida?) ramifica la ejecución. Si la solicitud no es válida, el flujo procede a 'Format Error Response' (Formatear Respuesta de Error).


4. Procesamiento de IA (Ruta de Éxito): Si es válida, el flujo llega al nodo n8n 'PDF Vector - Ask Question' (Vectorial de PDF - Hacer Pregunta). Este paso crítico utiliza la URL del documento y el prompt del usuario para realizar RAG, extrayendo la respuesta contextual más relevante.


5. Formatear Respuesta de Éxito: Un nodo Code subsiguiente de n8n toma la respuesta generada por PDF Vector, calcula una puntuación de confianza simulada y estructura la salida JSON enriquecida final, incluyendo metadatos de procesamiento y el ID de sesión.


6. Manejo de Errores (Ruta de Fallo): Si la validación de la solicitud falla, el nodo Code 'Format Error Response' compila los errores de validación en un JSON de error limpio y estructurado.


7. Salida Final: Tanto las rutas de éxito como las de error convergen en el nodo n8n 'Send Response' (Enviar Respuesta) (Respond to Webhook), que envía inmediatamente los datos JSON apropiados de vuelta al cliente de origen, completando el ciclo de la solicitud API.

Para desplegar esta completa plantilla de flujo de trabajo de n8n, sigue estos pasos:

1. Importar: Copia todo el código JSON proporcionado e impórtalo directamente en tu instancia de n8n usando el menú 'New' (Nuevo) y seleccionando 'Import from JSON' (Importar desde JSON).


2. Configuración de Credenciales: El nodo n8n 'PDF Vector - Ask Question' requiere credenciales (normalmente una clave API para el servicio de IA subyacente como OpenAI o servicios vectoriales similares). Asegúrate de que estén configuradas de forma segura.


3. Activación del Webhook: El disparador Webhook de n8n está configurado para responder a solicitudes POST en la ruta /doc-qa. Tras guardar el flujo de trabajo de n8n, asegúrate de que esté activado (cambia el interruptor en la esquina superior derecha).


4. Pruebas: Prueba la API enviando una solicitud POST a la URL del webhook de tu instancia de n8n, incluyendo los parámetros obligatorios documentUrl y question en el cuerpo JSON.

Webhook (n8n trigger): Nombrado 'Webhook'. Sirve como el punto de entrada de la API, configurado para el método POST en la ruta /doc-qa. Escucha las solicitudes externas de preguntas y respuestas sobre documentos.
Code (n8n node): Nombrado 'Validate Request' (Validar Solicitud). Realiza el saneamiento de la entrada, comprobando los parámetros requeridos (documentUrl y question) y estableciendo una bandera booleana para la validez. Es crucial para estabilizar el flujo de trabajo de n8n.
If (n8n node): Nombrado 'Valid Request?' (¿Solicitud Válida?). Controla el flujo, dirigiendo las solicitudes válidas a la ruta de procesamiento de IA y las no válidas a la ruta de formateo de errores.
PDF Vector (n8n node): Nombrado 'PDF Vector - Ask Question' (Vectorial de PDF - Hacer Pregunta). El componente de inteligencia principal. Procesa la URL del documento proporcionada en la solicitud y utiliza la lógica RAG para generar una respuesta contextual a la pregunta del usuario.
Code (n8n node): Nombrado 'Format Success Response' (Formatear Respuesta de Éxito). Se encarga de la transformación final de los datos, estructurando la respuesta de la IA, calculando una puntuación de confianza y empaquetándola en un formato JSON claro y fácil de usar para el cliente.
Code (n8n node): Nombrado 'Format Error Response' (Formatear Respuesta de Error). Prepara un mensaje de error estandarizado cuando falla la validación inicial de la solicitud, asegurando una experiencia de API coherente.

• Respond to Webhook (n8n node): Nombrado 'Send Response' (Enviar Respuesta). Este es el nodo final de n8n que envía inmediatamente los datos JSON estructurados de vuelta al cliente que inició el disparador de n8n.