Ventana de Contexto

Responde preguntas sobre un documento persistido

Equivale a POST https://claix.dev/document-context/{document_id}. Recibe un document_id en la URL (el que devolvió una extracción con window_context activo) y un array questions de objetos { question, format } en JSON. Carga markdown_content de la tabla documents, llama a Gemini 3.6 con el mismo modelo y generationConfig que el resto de funciones, y devuelve { user_ask, ia_response, log_id } con respuestas tipadas según el format de cada pregunta (string | int | boolean | timestamp | array, o null). Si la verificación de fuente está activada en consulta a documentos, cada ítem de ia_response es { value, source } con la evidencia citada del markdown (texto plano). Máximo 5 preguntas y 400 caracteres por pregunta. El documento debe pertenecer a la cuenta de la API key y no haber expirado.

post/document-context/{document_id}

Request

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

Path parameters

document_idstring uuid required

UUID del documento persistido en documents.

Request body

Example request

{
  "questions": [
    {
      "question": "¿Cuál es la penalización exacta por cancelación anticipada?",
      "format": "string"
    },
    {
      "question": "¿Qué empresa figura como arrendataria y cuál es su CIF?",
      "format": "string"
    }
  ]
}

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": "¿Cuál es la penalización exacta por cancelación anticipada?",
      "format": "string"
    },
    {
      "question": "¿Qué empresa figura como arrendataria y cuál es su CIF?",
      "format": "string"
    }
  ],
  "ia_response": [
    "El 15 % del importe restante del contrato.",
    "Inversiones Delta S.L., CIF B12345678"
  ],
  "log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34"
}

Changes

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