Crea en n8n un flujo de preguntas y respuestas sobre documentos con citas validadas y revisión humana
Diseña un flujo de trabajo en n8n que extraiga evidencia documental, valide respuestas estructuradas, reintente de forma segura y derive los resultados inciertos a revisión humana.
Resumen · TL;DR
Un diseño práctico para responder preguntas a partir de documentos en n8n, comprobar las citas, limitar los reintentos y separar la revisión de respuestas de la aprobación de llamadas a herramientas que implican riesgos.
Puntos clave
- Mantén juntos los identificadores y las versiones de los documentos, las referencias de página y el texto original durante la extracción y la recuperación.
- Valida tanto la estructura de una respuesta como la existencia de la evidencia citada en el texto fuente proporcionado.
- Limita los reintentos de fallos transitorios; deriva a revisión los fallos de validación persistentes y las respuestas sin respaldo, o abstente de responder.
- La aprobación de herramientas en n8n controla si un agente ejecuta una herramienta; no sustituye la revisión de la calidad de las respuestas.
En esta página (7)
Empieza con un conjunto de evidencia pequeño y verificable: extrae el texto con identificadores de página o sección, pide al modelo que responda únicamente a partir de ese texto y rechaza las respuestas cuyas citas no se puedan comprobar. En n8n, usa ramas normales del flujo de trabajo para validar y revisar las respuestas, y reserva la aprobación humana de AI Agent para las llamadas a herramientas que puedan ejecutar acciones con consecuencias importantes.
La configuración siguiente es un diseño ilustrativo, no una exportación de un flujo de trabajo probado. La configuración de los nodos y las integraciones disponibles pueden variar según la versión de n8n y el proveedor.
Requisitos previos y estructura del flujo de trabajo
Necesitas una instancia de n8n, acceso a un modelo capaz de procesar texto mediante una integración compatible o un endpoint HTTP, un método para extraer texto de documentos y un lugar donde almacenar los documentos y los registros de revisión. Para archivos PDF escaneados, añade OCR; la extracción de texto habitual de PDF puede devolver poco texto o ninguno. Decide quién puede acceder a cada documento antes de conectar un sistema de recuperación.
Crea dos etapas conectadas:
- Ingesta: disparador de documento → extracción de texto u OCR → división en registros por página o sección → almacenamiento del texto y los metadatos.
- Respuesta: disparador de pregunta → recuperación de registros autorizados → extracción con el modelo → validación en un nodo Code → respuesta, reintento limitado o cola de revisión.
Conserva document_id, version, page y text en cada registro almacenado. Una cita debe remitir a una versión y una página concretas de un documento, no solo a un nombre de archivo. Si tu extractor no puede conservar los límites de página, usa identificadores de sección estables y etiquétalos correctamente. Rechaza los resultados de extracción vacíos en lugar de enviarlos al modelo.
Para una colección pequeña, recupera los registros por identificador de documento y pasa directamente las páginas pertinentes. Para colecciones más grandes, añade un paso de búsqueda o recuperación, pero conserva los mismos metadatos. La recuperación puede pasar por alto la respuesta; una respuesta que parece válida no demuestra que se hayan encontrado todas las páginas pertinentes.
Define el contrato de respuesta
En el nodo del modelo, solicita un objeto JSON con una cadena answer, un status de answered o insufficient_evidence y un array evidence. Cada elemento de evidencia debe contener document_id, version, page y una cita exacta en quote, copiada de los registros proporcionados. Indica al modelo que ignore las instrucciones que encuentre dentro de los documentos, que los trate como datos no confiables y que devuelva insufficient_evidence cuando el texto proporcionado no respalde una respuesta.
Este es un ejemplo ilustrativo de respuesta:
{
"status": "answered",
"answer": "The agreement renews annually.",
"evidence": [
{
"document_id": "agreement-17",
"version": "v2",
"page": 3,
"quote": "This agreement renews for successive one-year terms."
}
]
}
La cita y los identificadores son ejemplos, no datos sobre un acuerdo real. Exige al menos un elemento de evidencia para una respuesta contestada y ningún elemento de evidencia para una respuesta por evidencia insuficiente. Muestra las citas con el nombre o identificador del documento, la versión, la página y la cita textual; añade un enlace solo si tu aplicación puede construir un enlace autorizado a esa fuente exacta.
Valida la salida y las citas en n8n
Después de la llamada al modelo, analiza su JSON y pasa el objeto analizado junto con los registros realmente recuperados a un nodo Code. El siguiente JavaScript ilustrativo presupone un único elemento de entrada, con la respuesta analizada en result y un array de registros en sources, cada uno con document_id, version, page y text. Adapta los nodos anteriores para proporcionar esa estructura; los errores de análisis deben dirigirse a la rama de fallo.
const { result, sources } = $input.first().json;
const errors = [];
if (!result || typeof result !== 'object' || Array.isArray(result)) {
errors.push('Result must be an object');
} else {
if (!['answered', 'insufficient_evidence'].includes(result.status))
errors.push('Invalid status');
if (typeof result.answer !== 'string' || !result.answer.trim())
errors.push('Missing answer');
if (!Array.isArray(result.evidence)) {
errors.push('Evidence must be an array');
} else {
if (result.status === 'answered' && result.evidence.length === 0)
errors.push('Answered response needs evidence');
if (result.status === 'insufficient_evidence' && result.evidence.length !== 0)
errors.push('Insufficient-evidence response must not cite evidence');
for (const e of result.evidence) {
const validFields = e && typeof e.document_id === 'string' &&
typeof e.version === 'string' && Number.isInteger(e.page) &&
typeof e.quote === 'string' && e.quote.trim().length > 0;
if (!validFields) {
errors.push('Invalid evidence fields');
continue;
}
const source = Array.isArray(sources) && sources.find(s =>
s.document_id === e.document_id && s.version === e.version &&
s.page === e.page && typeof s.text === 'string'
);
if (!source || !source.text.includes(e.quote))
errors.push('Citation or exact quote not found in retrieved source');
}
}
}
return [{ json: { result, errors, valid: errors.length === 0 } }];
Este código comprueba un contrato pequeño y explícito, así como la presencia exacta de la cita; no es un validador general de JSON Schema. Añade una biblioteca o un servicio de validación de esquemas si necesitas restricciones como longitudes máximas o el rechazo de campos adicionales. La coincidencia exacta puede fallar por errores de OCR o cambios en los espacios en blanco. Si normalizas el texto, aplica la misma normalización documentada tanto a la fuente como a la cita y conserva el texto original para quienes revisen el resultado.
Lo más importante es que una cita coincidente no demuestra que la respuesta se derive de ella. Una persona revisora o un proceso independiente de control de calidad debe evaluar si el pasaje citado respalda realmente cada afirmación sustancial. Para respuestas de alto impacto, envía a revisión incluso los resultados estructuralmente válidos.
Añade reintentos limitados y una vía para abstenerse
Usa un nodo IF después de la validación. Envía las respuestas válidas y de bajo riesgo al siguiente paso; para insufficient_evidence, devuelve una respuesta de abstención como «No he encontrado suficiente evidencia en los documentos proporcionados». Deriva los resultados no válidos a una rama de reintento con un contador almacenado en el elemento del flujo de trabajo.
Una política inicial práctica es la siguiente:
- Reintenta los errores temporales de red y los límites de tasa hasta dos veces, con esperas cada vez mayores; respeta cualquier demora de reintento indicada por el proveedor.
- Reintenta una vez el JSON mal formado o las comprobaciones de citas fallidas, devolviendo al modelo únicamente los errores de validación y los mismos registros de fuentes autorizadas.
- No reintentes repetidamente los casos de permisos ausentes, extracción vacía o falta de evidencia. Corrige la entrada, solicita otro documento o envía el caso a revisión.
- Una vez alcanzado el límite, registra el fallo y devuelve un estado de revisión pendiente o de indisponibilidad, no la respuesta sin validar.
Estas son decisiones de diseño, no garantías. Clasifica los errores del proveedor según la respuesta real de tu integración. Si un reintento puede repetir una operación de escritura, usa una clave de idempotencia a nivel de aplicación o comprueba primero si ya existe un registro; una solicitud repetida no debe crear tickets de revisión duplicados ni enviar mensajes duplicados.
Separa la revisión de respuestas de la aprobación de herramientas
Para revisar una respuesta, crea un registro que contenga la pregunta, la respuesta propuesta, los errores de validación, los pasajes citados, la versión del documento y un enlace a la fuente autorizada. Una persona revisora debe aprobar, corregir o rechazar la respuesta; registra su decisión y su identidad antes de publicar la respuesta. Protege el canal de revisión y evita copiar texto sensible de los documentos en canales que no cuenten con los controles de acceso adecuados.
Esto es distinto de Human review for tools de n8n. Según la documentación de n8n, esa función pausa un AI Agent antes de que se ejecute una herramienta seleccionada. La aprobación ejecuta la herramienta con la entrada especificada por la IA; el rechazo cancela la ejecución e informa al agente. Por sí sola, esta función no valida una respuesta.
Para proteger una acción como enviar una respuesta a un destinatario externo o actualizar un registro, abre el panel Tools del AI Agent, configura un canal de Human review y conecta la herramienta correspondiente a través de ese paso de revisión. La documentación enumera canales como n8n Chat y Slack. Incluye el nombre y los parámetros de la herramienta en el mensaje de revisión mediante las expresiones documentadas $tool.name y $tool.parameters. En el prompt de sistema del agente, identifica las herramientas sujetas a aprobación e indícale que explique cualquier rechazo en lugar de reintentar silenciosamente o buscar una forma de eludirlo. Establece una política operativa para las solicitudes que queden sin respuesta, por ejemplo, marcarlas como pendientes y escalarlas; no presupongas que exista un comportamiento automático de tiempo de espera.
Resolución de problemas y lista de comprobación para la puesta en producción
- Las citas fallan pese a que la página es correcta: revisa el OCR, los saltos de línea, la numeración de páginas y las discrepancias de versión. No sustituyas silenciosamente la página por otra.
- Las respuestas omiten información pertinente: revisa la cobertura de la recuperación y los permisos de los documentos antes de aumentar los reintentos.
- Las personas revisoras no pueden verificar un pasaje: incluye la versión exacta y un enlace funcional a la fuente con control de acceso, no solo un nombre de archivo.
- El agente intenta ejecutar una acción de riesgo sin revisión: comprueba que la acción esté conectada realmente a través del paso de revisión humana y prueba tanto el rechazo como la aprobación.
Antes de la puesta en producción, prueba una respuesta respaldada, una respuesta ausente, una cita inventada, JSON mal formado, un fallo transitorio del proveedor y una llamada a herramienta rechazada. Un flujo de trabajo útil puede indicar «evidencia insuficiente» y conservar esa decisión; nunca debe convertir una validación fallida en una respuesta presentada como fiable.
Fuentes
FAQ
¿La revisión humana de n8n valida una respuesta basada en documentos?
No por sí sola. La función de revisión humana documentada pausa determinadas llamadas a herramientas de AI Agent para que se aprueben o rechacen. Crea una vía independiente de validación y revisión de respuestas para comprobar las citas y el respaldo de las afirmaciones.
¿Una cita exacta demuestra que una respuesta es correcta?
No. Demuestra que el texto citado aparece en el registro de la fuente comprobada, pero no que el pasaje respalde todas las afirmaciones de la respuesta. Revisa la relación entre la respuesta y la evidencia.
¿Qué debe ocurrir cuando un documento no contiene la respuesta?
Devuelve una respuesta de evidencia insuficiente o deriva la pregunta a revisión. Reintentar repetidamente el modelo no puede sustituir de forma fiable el material fuente que falta.
Artículos relacionados
Guides
Crea un flujo de extracción de datos recuperable en n8n
Diseña un flujo de extracción en n8n que valide registros, reintente fallos transitorios y derive las excepciones a revisión humana sin duplicar escrituras.
Guides
Crea un flujo de extracción de datos en n8n que proteja la privacidad
Diseña un flujo de extracción en n8n que valide los resultados estructurados, gestione los fallos de forma segura y envíe las acciones sensibles a revisión humana.
Guides
Crea un flujo de trabajo fiable en n8n para revisar cambios en repositorios
Diseña en n8n un flujo de trabajo que extraiga datos estructurados de cambios en repositorios, valide los resultados, reintente errores transitorios, verifique las pruebas y derive las acciones de riesgo a una persona.
Guides
Crea un flujo de clasificación de tickets de soporte en n8n con validación, reintentos y aprobación humana
Diseña un flujo de trabajo en n8n que extraiga campos de los tickets de soporte, los valide, gestione los fallos y exija aprobación humana antes de ejecutar acciones importantes.