API-First · GraphRAG Intelligence

Documentación de la API

Integra el motor de conocimiento de Lumentia en tu CRM, ERP, chatbot o automatización. Una API REST para búsqueda semántica, conversación y agentes.

Explorar Swagger UI Especificación OpenAPI

Autenticación

Todas las llamadas se autentican con una API key por cliente enviada en la cabecera X-API-Key, o mediante un token JWT (sesión web). Cada key está acotada a su tenant: no puede consultar datos de otro cliente.

# Autenticación con API key
curl -X POST https://lumentia.duarus.com/api/v1/search/oneshot \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $LUMENTIA_API_KEY" \
  -d '{ "query": "¿Cuál es la cobertura de la póliza X?" }'
        

OneShot API

Consulta puntual sin historial conversacional: pregunta → recuperación → respuesta. Ideal para CRM, tickets, RRSS y automatizaciones.

Solicitud

POST /api/v1/search/oneshot
{
  "query": "¿Mi portátil tiene garantía de 24 meses?",
  "top_k": 12,
  "rerank": true,
  "external_search": false,
  "folder_include": ["manuales", "garantias"]
}
            

Respuesta

{
  "response": "Sí, este modelo incluye...",
  "fuentes": [
    { "archivo": "garantia.pdf",
      "chunk_text": "..." }
  ],
  "tiempo_ms": 842
}
            

*El tiempo de respuesta es ilustrativo de una consulta puntual, no un benchmark de latencia.

Recursos principales

Chat conversacional

Hilos con memoria de sesión, derivación a humano y canales (WhatsApp, web, email).

/api/v1/chat/*

Google Drive

Sincronización, indexación y búsqueda sobre tu Drive autorizado.

/api/v1/drive/*

Agent Workers

Agentes que ejecutan herramientas, consultan APIs y lógica compleja.

/api/v1/agent/*