Modo Agente

Excel/CSV a JSON con extracción y razonamiento Modo Agente

Equivalente a POST /api/excel-json seguido de una fase agente con Gemini. Devuelve la respuesta de extracción (data, mapa_columnas, log_id, etc.) más agent_data según agent_definition. El schema debe tener is_agent_mode activado. Si la verificación de fuente está activada en el schema, data y agent_data usan { value, source }. Misma petición multipart (file + schema_id) y mismos códigos de error que /api/excel-json; además puede devolver 400 si el schema no tiene Modo Agente o agent_definition inválida, o 502 si falla la fase agente.

post/agent/excel-json

Request

  • Base URL: https://claix.dev
  • URL: https://claix.dev/agent/excel-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_filas_procesadasinteger

Número de filas de datos transformadas.

mapa_columnasobject

Diccionario que muestra qué columna original se emparejó con qué propiedad del schema.

dataobject[]

Registros transformados según el schema. Si la verificación de fuente está activada en el schema, cada propiedad es un objeto { value, source } (source cita columna y fila; si no hay evidencia, requires_human_revision). Si la verificación de fuente está desactivada, los valores siguen siendo planos.

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": "Leads de Ventas",
  "total_filas_procesadas": 247,
  "mapa_columnas": {
    "Nom_cliente": "nombre_completo",
    "Tlf": "telefono_movil",
    "mail de contacto": "email_contacto"
  },
  "data": [
    {
      "nombre_completo": "Ana María Gómez",
      "cargo": "CEO & Founder",
      "empresa": "TechSolutions",
      "email_contacto": "ana.gomez@techsolutions.com",
      "telefono_movil": "+1 (555) 019-2231"
    }
  ],
  "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.