Modo Agente

Documento a JSON con extracción y razonamiento Modo Agente

Equivalente a POST /api/doc-json más fase agente. Devuelve data[], log_id y agent_data. Requiere is_agent_mode. Si la verificación de fuente está activada en el schema, data y agent_data usan { value, source }. Formatos admitidos: .docx, .txt, .md, .rtf. Tamaño máximo: 10 MB; texto extraído máx. 300.000 caracteres.

post/agent/doc-json

Request

  • Base URL: https://claix.dev
  • URL: https://claix.dev/agent/doc-json
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Response

Extracción y fase agente completadas correctamente

successboolean
schema_utilizadostring

Nombre del schema aplicado.

total_registrosinteger

Siempre 1 en este endpoint: el documento completo se trata como una única fuente de datos, no como una tabla de múltiples filas.

dataobject[]

Contiene exactamente un objeto con los datos extraídos del documento, según las propiedades definidas en el schema. Los datos no encontrados en el texto se devuelven como null. Si la verificación de fuente está activada en el schema, cada propiedad es { value, source } (source cita página, párrafo y línea).

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.

agent_dataAgentData required

Respuestas tipadas de la fase Modo Agente según agent_definition del schema. Las claves coinciden con los nombres definidos en el dashboard; los tipos dependen de cada campo (boolean, integer, string u opción cerrada). Opcionalmente puede incluir resumen_agent como string si está configurado en el schema. Si la verificación de fuente está activada en el schema, cada campo (salvo resumen_agent si se pide como texto plano) es { value, source }.

Example response

{
  "success": true,
  "schema_utilizado": "Contratos de Alquiler",
  "total_registros": 1,
  "data": [
    {
      "nombre_arrendatario": "Laura Fernández Ruiz",
      "nombre_arrendador": "Inversiones Delta S.L.",
      "direccion_inmueble": "Calle Mayor 14, 3ºB, Madrid",
      "renta_mensual": 950,
      "fecha_inicio": "2026-04-01"
    }
  ],
  "log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34",
  "agent_data": {
    "clausula_penalizacion": true,
    "salario": 55000,
    "es_parcial": false,
    "resumen_contrato": "Contrato indefinido con jornada completa."
  }
}

Changes

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