API

OneShot y Agent Workers: la API que hace el trabajo

6 min de lectura · API

Lumentia no te obliga a vivir dentro de su interfaz. El valor está en conectar el conocimiento con tus sistemas: CRM, ERP, tickets, redes sociales o automatizaciones. Para eso hay dos primitivas: OneShot (consulta puntual) y Agent Workers (agentes con herramientas).

OneShot: pregunta → respuesta, sin equipaje

OneShot está pensado para preguntas concretas que no necesitan historial conversacional. Es un endpoint REST ligero que recibe una consulta y devuelve la respuesta con sus fuentes:

POST /api/v1/search/oneshot
{
  "query": "¿Cuál es la cobertura de la póliza X?",
  "top_k": 12
}
→ { "response": "...", "fuentes": [...], "tiempo_ms": 842 }
        

Al no cargar todo el historial, es ideal para automatizaciones de primera línea: un bot de RRSS, un campo de búsqueda en tu CRM o un webhook que responde en milisegundos.

Agent Workers: agentes que actúan

Cuando la tarea es más que responder (consultar una API, ejecutar un flujo, leer una base de datos), entran los Agent Workers. Son agentes que pueden usar herramientas, consultar APIs y ejecutar lógica compleja sin intervención humana, dentro de un flujo definido.

Seguridad en cada acción

Cada herramienta y credencial se resuelve acotada al tenant; las credenciales viven cifradas en una bóveda; y las escrituras usan idempotencia y reintentos para no duplicar recursos ante un timeout. Un fallo de escritura corta el flujo en lugar de reportarse como éxito.

API-first, de verdad

Todo lo que hace la interfaz se puede hacer por API: búsqueda, chat, sincronización de Drive, gestión de usuarios y agentes. La especificación completa está disponible como OpenAPI y explorable en Swagger UI.

La IA deja de ser una caja cerrada: el conocimiento se vuelve una capacidad que conectas a tus flujos existentes.