Espacios de conocimiento para agentes de IA: consulta varios documentos y conecta sus datos

Qué es un espacio de conocimiento

Un espacio de conocimiento es un agrupador lógico de documentos persistentes identificados por un space_id. No es un archivo ni una carpeta: es una capa de consulta que permite a Claix y a tus agentes razonar sobre varios documentos relacionados como si formaran un expediente coherente.

• Espacio por cliente: contratos, facturas, correos formalizados y políticas aplicables.
• Espacio por proveedor: acuerdos marco, albaranes, facturas y condiciones de pago.
• Espacio por proyecto: presupuestos, actas, entregables y cambios de alcance.
• Espacio por expediente legal: contratos, anexos, enmiendas y correspondencia.
• Espacio por candidato: CV, carta de presentación, certificados y evaluaciones.
• Espacio por auditoría: informes, evidencias, checklists y respuestas de compliance.
• Espacio por ticket de soporte: manuales, logs exportados, políticas y comunicaciones.

// Consulta sobre un solo documento
{
  "document_id": "doc_invoice_83f4",
  "questions": [
    "¿Cuál es el importe total de esta factura?"
  ]
}

// Consulta cruzada sobre un espacio de conocimiento
{
  "space_id": "space_supplier_acme_2026",
  "questions": [
    "¿Cuál es el total facturado por este proveedor en Q1?",
    "¿Alguna factura supera el límite del contrato?",
    "¿Hay discrepancias entre las facturas y el acuerdo marco?"
  ]
}

De una consulta individual a una consulta cruzada

Consultar un document_id resuelve bien preguntas puntuales sobre un archivo concreto. Consultar un space_id resuelve preguntas que requieren contexto distribuido entre varios documentos persistentes.

Ejemplo con document_id: «¿Cuál es la fecha de vencimiento de este contrato?» Claix busca en un solo documento y devuelve la cláusula aplicable.

Ejemplo con space_id: «¿El total facturado por este proveedor en el trimestre coincide con el límite del contrato marco?» Claix consulta las facturas del espacio, el contrato asociado y devuelve una comparación con fuentes.

Qué preguntas permite responder

Un space_id amplía el tipo de razonamiento que un agente puede delegar a Claix. Estas son preguntas representativas que un espacio de conocimiento puede resolver:

• «¿Cuál es el importe total facturado por este proveedor en el periodo?»
• «¿Alguna factura del espacio supera el límite de responsabilidad del contrato?»
• «¿Hay discrepancias entre los totales de las facturas y el presupuesto aprobado?»
• «¿Qué cláusulas del contrato marco no aparecen reflejadas en los anexos?»
• «¿Qué documentos del expediente mencionan la misma fecha de entrega?»
• «Resume las obligaciones del proveedor cruzando contrato y condiciones generales.»
• «¿Cuántas facturas incluyen el mismo número de pedido?»
• «¿Qué candidato del espacio cumple el requisito de experiencia mínima?»
• «¿Existen incoherencias entre el informe de auditoría y las evidencias adjuntas?»
• «Devuelve en JSON la comparación de importes netos por documento del espacio.»

Este tipo de consultas encaja con la investigación sobre question answering multi-documento: en lugar de pedir al modelo que «recuerde» varios archivos en un prompt, el agente delega la recuperación y el cruce de evidencias a una capa especializada con documentos persistentes identificables.

Procesar una vez y consultar el conjunto

La ventaja operativa de los espacios de conocimiento es la misma que la de la memoria persistente, aplicada a un conjunto: procesas cada documento una sola vez y consultas el grupo cuando el workflow lo requiera.

Subir factura A → document_id
Subir factura B → document_id
Subir contrato C → document_id
   ↓
Asociar los tres a space_id: "proveedor_acme_2026"
   ↓
Pregunta: "¿Cuál es el total facturado y hay discrepancias con el contrato?"
   ↓
Claix consulta el conjunto sin reprocesar archivos

Este enfoque evita:

• Reenviar varios PDFs o Excels en cada interacción del agente.
• Reprocesar archivos que ya fueron convertidos en contexto persistente.
• Meter decenas de páginas en el prompt y esperar coherencia.
• Construir pipelines propios de chunking, embeddings e índices por expediente.
• Perder la trazabilidad entre una respuesta y los documentos que la sustentan.
• Mezclar información de distintos clientes o proveedores en la memoria conversacional.

Tu aplicación:
→ define el space_id y sus relaciones de negocio
→ controla permisos, tenants y acceso del agente
→ decide cuándo crear, actualizar o cerrar un espacio

Claix:
→ procesa documentos una vez
→ conserva contexto persistente por document_id
→ responde consultas sobre un document_id o un space_id
→ devuelve datos estructurados, lenguaje natural o null si no hay evidencia

Comparar documentos con IA

Uno de los casos más valiosos de un space_id es la comparación documental. El agente no necesita leer manualmente contrato, facturas y anexos: formula una pregunta de comparación y Claix devuelve el resultado con referencia a las fuentes.

• Comparar fechas de entrega entre contrato y albaranes del espacio.
• Verificar si las condiciones de pago del acuerdo marco se reflejan en cada factura.
• Contrastar versiones de una cláusula entre el contrato principal y sus anexos.
• Identificar qué documentos del expediente mencionan la misma entidad o importe.
• Detectar si un informe resume correctamente los datos de las evidencias adjuntas.

Sumar, cuadrar y detectar discrepancias

Los espacios de conocimiento permiten operaciones analíticas sobre conjuntos documentales que un document_id individual no puede resolver por sí solo.

Sumar

• Total de importes netos de todas las facturas del espacio.
• Suma de horas facturadas en un proyecto a partir de varios partes.
• Agregación de líneas de pedido distribuidas en varios albaranes.
• Total de penalizaciones mencionadas en informes de un mismo expediente.

Cuadrar

• Verificar si la suma de facturas coincide con el presupuesto aprobado.
• Comprobar si los totales de albaranes cuadran con la factura consolidada.
• Validar que los importes del contrato marco encajan con las facturas emitidas.
• Confirmar que los datos del informe final concuerdan con las evidencias del espacio.

Detectar incoherencias

• Facturas con importes superiores al tope contractual.
• Fechas de entrega contradictorias entre contrato y albaranes.
• Cláusulas del acuerdo marco ausentes en anexos firmados.
• Datos de un candidato que no coinciden entre CV y certificados del espacio.
• Referencias de pedido duplicadas o inconsistentes entre documentos.

Casos de uso: facturas, contratos y proveedores

Ejemplo de consulta:

{
  "space_id": "space_supplier_acme_2026",
  "questions": [
    "¿Cuál es el total facturado en Q1?",
    "¿Alguna factura supera el límite del contrato marco?",
    "¿Hay discrepancias entre albaranes y facturas del espacio?"
  ]
}

Casos de uso: contratos y equipos legales

Ejemplo de consulta:

{
  "space_id": "space_deal_customer_284",
  "questions": [
    "¿Cuál es el preaviso de cancelación en el contrato vigente?",
    "¿Los anexos mantienen la misma jurisdicción que el contrato principal?",
    "Resume las obligaciones de confidencialidad de todos los documentos del espacio."
  ]
}

Casos de uso: contabilidad y finanzas

Ejemplo de consulta:

{
  "space_id": "space_finance_q1_2026",
  "questions": [
    "¿Cuál es la suma de importes netos de todas las facturas?",
    "¿Hay facturas duplicadas por número o referencia?",
    "Devuelve en JSON el desglose por proveedor."
  ]
}

Casos de uso: recursos humanos y selección

Ejemplo de consulta:

{
  "space_id": "space_candidate_126",
  "questions": [
    "¿Cuántos años de experiencia relevante aparecen en los documentos?",
    "¿Hay inconsistencias entre el CV y los certificados?",
    "Resume las titulaciones acreditadas en el espacio."
  ]
}

Casos de uso: soporte y éxito de cliente

Ejemplo de consulta:

{
  "space_id": "space_customer_992",
  "questions": [
    "¿Qué versión del producto cubre la documentación del espacio?",
    "¿Existe una limitación conocida descrita en algún manual?",
    "¿Cuál es el plazo de respuesta según el SLA vigente?"
  ]
}

Casos de uso: operaciones y logística

Ejemplo de consulta:

{
  "space_id": "space_logistics_project_47",
  "questions": [
    "¿Cuántos albaranes del espacio carecen de referencia de pedido?",
    "¿Las fechas de entrega son coherentes entre pedido y albaranes?",
    "Devuelve en JSON los productos con discrepancia de cantidad."
  ]
}

Casos de uso: compliance y auditoría

Ejemplo de consulta:

{
  "space_id": "space_audit_2026_h1",
  "questions": [
    "¿Hay incoherencias entre el informe y las evidencias adjuntas?",
    "¿Qué documentos del espacio mencionan tratamiento de datos personales?",
    "Resume los hallazgos críticos con referencia a fuentes."
  ]
}

Un sistema más eficiente para agentes

Los espacios de conocimiento completan la evolución de Claix: de procesar un documento a consultarlo, y de consultarlo a consultar conjuntos relacionados con trazabilidad.

Reenviar archivos en cada interacción
   ↓
Consultar un solo document_id
   ↓
Meter todo en el chat del agente
   ↓
Consultar un space_id con documentos persistentes
   ↓
Respuesta cruzada, trazable y reutilizable

Preguntas claras para mejores respuestas

La calidad de una consulta sobre un space_id depende tanto de la formulación como del contenido del espacio. Preguntas vagas producen respuestas vagas; preguntas concretas permiten comparaciones, cálculos y detección de discrepancias útiles.

// Pregunta poco útil
"¿Qué puedes decirme de estos documentos?"

// Pregunta clara y accionable
"¿Cuál es la suma de importes netos de las facturas del espacio
 y qué documento aporta el mayor desvío respecto al contrato?"

Buenas prácticas al formular preguntas para un space_id:

• Especifica qué comparar, sumar o verificar.
• Indica el periodo, la entidad o el criterio cuando aplique.
• Pide formato estructurado (JSON) si el agente necesita actuar programáticamente.
• Formula una pregunta por concepto; usa el límite de cinco preguntas para cubrir ángulos distintos.
• Evita preguntas que mezclen varios objetivos sin criterio claro.

Cinco preguntas por consulta

Cada petición a un space_id admite hasta cinco preguntas. Este límite favorece consultas enfocadas y respuestas trazables, en lugar de solicitudes abiertas que diluyen la evidencia documental.

Ejemplo de consulta con cinco preguntas complementarias:

• «¿Cuál es el importe total neto de las facturas del espacio?»
• «¿Alguna factura supera el límite del contrato marco?»
• «¿Hay albaranes sin factura correspondiente?»
• «¿Qué documento aporta el mayor desvío respecto al presupuesto?»
• «Devuelve en JSON el desglose por proveedor con referencia a document_id.»

Si Claix no encuentra evidencia suficiente en los documentos del espacio para responder una pregunta concreta, devuelve null para esa pregunta. Esto permite al agente distinguir entre «no hay dato» y «sí hay dato», en lugar de inventar una respuesta.

Conclusiones basadas en documentos, no en suposiciones

Un agente fiable no debería inferir totales, plazos o discrepancias sin base documental. Los espacios de conocimiento permiten que las conclusiones se apoyen en evidencia recuperada del conjunto persistente.

Pregunta del agente
   ↓
Consulta space_id
   ↓
Claix busca evidencia en los documentos del espacio
   ↓
Devuelve respuesta con fuentes o null si no hay base documental
   ↓
El agente actúa sobre hechos, no sobre suposiciones

Ejemplo de respuesta con trazabilidad:

{
  "total_net_amount": 47250.00,
  "currency": "EUR",
  "exceeds_contract_limit": false,
  "sources": [
    { "document_id": "doc_invoice_001", "field": "net_amount", "value": 15750.00 },
    { "document_id": "doc_invoice_002", "field": "net_amount", "value": 16200.00 },
    { "document_id": "doc_invoice_003", "field": "net_amount", "value": 15300.00 }
  ],
  "contract_reference": {
    "document_id": "doc_contract_marco_7291",
    "annual_limit": 50000.00
  }
}

Cómo encaja con la memoria documental persistente

Los espacios de conocimiento no reemplazan la memoria persistente: la extienden. Cada documento del espacio debe estar procesado en modo persistente con su propio document_id. El space_id es la capa que los relaciona para consultas cruzadas.

La evolución es natural: primero procesas y persistes documentos individuales; después agrupas los que pertenecen al mismo contexto de negocio; finalmente, tu agente consulta el espacio completo cuando la pregunta lo requiera.

Espacios de conocimiento para SaaS y automatizaciones

Para productos SaaS y flujos automatizados, el patrón es consistente: tu backend crea el space_id, asocia los document_id procesados y delega las preguntas cruzadas a Claix cuando un agente o un workflow las necesite.

// Agente de finanzas: conciliación de proveedor
POST /query { space_id: "space_vendor_404", questions: [...] }

// Agente legal: revisión de cláusulas en un expediente
POST /query { space_id: "space_deal_839", questions: [...] }

// Automatización de onboarding: documentación de un candidato
POST /query { space_id: "space_candidate_126", questions: [...] }

// Agente de soporte: historial documental de un cliente
POST /query { space_id: "space_customer_992", questions: [...] }

Tu aplicación conserva la lógica de negocio —permisos, estados, notificaciones y acciones— mientras Claix aporta la capa de consulta documental cruzada sobre el conjunto persistente.

No es solo una colección de documentos

Un space_id no es equivalente a una carpeta compartida ni a un array de archivos en memoria. Es un recurso de consulta con semántica de negocio: Claix sabe que los documentos del espacio deben considerarse juntos al responder preguntas de comparación, agregación o detección de incoherencias.

Por qué esto importa para el futuro de los agentes

Los agentes empresariales evolucionan de responder preguntas aisladas a ejecutar workflows completos: conciliar facturas, revisar expedientes, auditar cumplimiento o preparar negociaciones. Esos workflows requieren acceso fiable a conjuntos documentales, no solo a archivos individuales.

• Menos dependencia de prompts saturados con múltiples PDFs.
• Más consultas estructuradas sobre expedientes completos.
• Mejor trazabilidad entre respuesta del agente y documentos fuente.
• Separación clara entre memoria conversacional y conocimiento documental agrupado.
• Capacidad de sumar, cuadrar y detectar discrepancias sin lógica ad hoc.
• Integración natural con automatizaciones y productos SaaS multi-tenant.

Los espacios de conocimiento convierten un conjunto de document_id persistentes en una unidad consultable para agentes de IA: la diferencia entre «tengo varios archivos» y «tengo un expediente sobre el que puedo razonar».

Conclusión

Claix permite pasar de consultas individuales por document_id a consultas cruzadas por space_id, manteniendo la promesa de la memoria persistente: procesar una vez, consultar muchas veces. Los espacios de conocimiento dan a tus agentes la capacidad de comparar, sumar, cuadrar y detectar discrepancias entre documentos relacionados, con respuestas trazables y null cuando no hay evidencia.

"No es solo una colección de PDFs.
Es un espacio de conocimiento consultable donde tu agente
puede comparar, sumar, cuadrar y detectar discrepancias
entre documentos persistentes — sin reprocesarlos."

Documentos sueltos → document_id persistente → space_id agrupado
→ pregunta cruzada → respuesta con fuentes → acción del agente