Espacios de Conocimiento

Responde preguntas cruzando todos los documentos de un espacio

Equivale a POST https://claix.dev/space-context/{space_id}. Mismo formato de entrada y de salida que POST /document-context/{document_id}: body con un array questions de objetos { question, format } (máximo 5 preguntas, 400 caracteres cada una; format ∈ string | int | boolean | timestamp | array) y respuesta { user_ask, ia_response, log_id } tipada y alineada 1:1. Si la verificación de fuente está activada en consulta a espacio de conocimiento, cada ítem de ia_response es { value, source } nombrando document_id y file_name. La única diferencia de alcance es que, en vez de un único documento, carga el markdown_content de todos los documentos vigentes cuyo espacio_id sea ese space_id, y responde cruzando la información entre ellos (comparar, sumar, relacionar o consolidar datos repartidos en varios archivos). El espacio debe pertenecer a la cuenta de la API key. Los documentos expirados se ignoran. Para acotar coste y mantener la precisión del modelo se cargan como máximo 50 documentos y 200.000 caracteres en total, repartidos entre ellos.

post/space-context/{space_id}

Request

  • Base URL: https://claix.dev
  • URL: https://claix.dev/space-context/{space_id}
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

space_idstring uuid required

UUID del espacio de conocimiento en espacios_conocimiento. Es el mismo valor que se envía como space_id opcional en los endpoints de extracción para agrupar el documento en ese espacio.

Request body

Example request

{
  "questions": [
    {
      "question": "¿Qué proveedor factura más en total sumando todas las facturas?",
      "format": "string"
    },
    {
      "question": "¿Hay algún contrato cuyo importe no coincida con su factura?",
      "format": "boolean"
    }
  ]
}

Response

Preguntas respondidas

log_idstring uuid nullable

Identificador del registro en usage_logs de esta llamada. Presente en respuestas de éxito de extracción, modo agente, document-context y space-context, y en la mayoría de errores una vez autenticada la petición. Puede omitirse si el insert del log falla.

Example response

{
  "user_ask": [
    {
      "question": "¿Qué proveedor factura más en total sumando todas las facturas?",
      "format": "string"
    },
    {
      "question": "¿Hay algún contrato cuyo importe no coincida con su factura?",
      "format": "boolean"
    }
  ],
  "ia_response": [
    "Suministros Omega S.A., 48.320 € entre tres facturas (feb, mar, abr).",
    true
  ],
  "log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34"
}

Changes

No recorded changes to this operation across all 1 revision of this API.