Iniciar sesión
Consulta RAG
Empieza escribiendo una pregunta. Puedes seguir preguntando sobre los mismos resultados — no hace falta repetir el contexto en cada mensaje.
Este asistente solo busca en el manual de usuario de Albalá. Puede completar con conocimiento general para orientarte mejor, pero lo dice explícitamente cuando lo hace — nunca se inventa un botón o menú concreto que no esté documentado.
Pregúntame cómo hacer algo en Albalá — p. ej. «¿cómo doy de alta un expediente?» o «¿dónde configuro los permisos de un usuario?».
Este asistente solo busca en el manual de usuario de MediaSearch. Puede completar con conocimiento general para orientarte mejor, pero lo dice explícitamente cuando lo hace — nunca se inventa un botón o menú concreto que no esté documentado.
Pregúntame cómo hacer algo en MediaSearch — p. ej. «¿cómo busco por licencia?» o «¿dónde subo un nuevo activo?».
Este asistente solo busca en el manual de usuario de Gestiona. Puede completar con conocimiento general para orientarte mejor, pero lo dice explícitamente cuando lo hace — nunca se inventa un botón o menú concreto que no esté documentado.
Pregúntame cómo hacer algo en Gestiona — p. ej. «¿cómo doy de alta un proyecto?» o «¿dónde gestiono los permisos de un usuario?».
Documentos indexados
Subir documento(s) (fichero)
La versión solo aísla dentro de un universo de manual (albala/mediasearch/gestional_user_manual) -- vacío = visible en cualquier versión.
Subir texto (p. ej. OCR o issue)
Describir documento (OCR → ISAD(G))
Plantillas de descripción
Una plantilla define qué campos devuelve POST /api/describe/{código} para un texto OCR.
Cada campo puede extraerse con el LLM (guiado por su instrucción) o llevar un valor fijo
(no gasta tokens; admite {hoy} = fecha de hoy). Un campo puede mapearse a un elemento de
ISAD(G), Dublin Core o MARC 21. El nombre de campo es exactamente la clave que
recibe la aplicación cliente (Albalá solo rellena los que coinciden con su esquema). Las plantillas son
globales. GET /api/describe/templates lista las activas.
¿Qué es una clave API?
Identifica a una aplicación o integración (Gestiona, Albalá, MediaSearch, un script
de carga masiva…) frente a RAG-IA, en vez de a una persona -- así puede llamar a
/api/ask, /api/chat o /api/describe sin que un
humano tenga que iniciar sesión. Se muestra completa una única vez, justo al crearla;
después solo se ve su prefijo (para identificarla, no se puede volver a recuperar).
Qué implica crear o gestionar una clave:
- Acceso a datos: el universo
archivalse filtra por los clientes asignados en "Clientes" (pestaña Configuración). Sin ningún cliente asignado, la clave no ve nada de ese universo (fail-closed) salvo que se marque explícitamente sin restricción -- comprobarlo antes de dar una clave nueva por lista para un cliente real. - Quién paga el LLM: el campo "Factura con" (en Detalles) decide con qué perfil de LLM responde esa clave. Sin perfil propio asignado, usa el perfil activo global -- es decir, ese tráfico lo paga la cuenta de Albadoc aunque sea de un cliente externo.
- Presupuesto: se puede fijar un límite de gasto mensual/anual/total en euros; al superarlo la clave deja de responder (HTTP 402) hasta ampliar el límite o empezar el siguiente periodo -- no es solo un aviso visual.
- Todo uso queda medido por clave, venga de
/api/ask,/api/chato/api/describe: peticiones y chunks recuperados (uso de RAG-IA) más tokens y coste estimado (uso del LLM).
Qué se puede sacar de cada clave (facturación): el botón 📄 de su fila descarga un informe de consumo en PDF del periodo elegido arriba (peticiones, tokens de entrada/salida y coste estimado en euros, desglosado por modelo) -- es un informe de consumo, no una factura fiscal formal. Para comparar varias claves a la vez o ver la serie temporal, usar la pestaña Estadísticas.
Mantenimiento
Vacía la caché de respuestas (exacta + semántica) — útil tras pruebas o cuando una respuesta cacheada quedó obsoleta. No borra conversaciones ni documentos.
Nueva clave API
Copia esta clave ahora — no se podrá ver de nuevo.
Claves registradas
Filtros
Separa siempre dos cosas que se cobran por criterios distintos: el uso de RAG-IA (peticiones, embeddings/chunks -- se contabiliza igual sea cual sea el motor LLM, y también para claves internas de demo o de Gestiona) y el uso del LLM (tokens y coste, depende del modelo/perfil asignado a cada clave).
Uso de RAG-IA — consulta
Peticiones y chunks recuperados por búsqueda semántica -- esto es lo que se le cobra a cualquier clave (interna o de cliente) por el propio servicio de RAG-IA, con independencia de qué LLM responda.
Uso del LLM
Tokens y coste estimado -- depende del modelo/perfil de LLM asignado a la clave (sección Configuración → Perfiles de LLM). Si el perfil es de un cliente con LLM cloud propio, este coste es sobre SU cuenta, no la de Albadoc.
Uso de RAG-IA — ingesta
Documentos y chunks indexados al subir/importar contenido -- ningún LLM interviene aquí, es embedding + Solr puro. No se puede filtrar por clave API (la ingesta no siempre pasa por una).
Perfiles de LLM
Afecta a /api/ask, /api/query y a los asistentes de chat. Puedes tener varios perfiles a la vez (p.ej. dos versiones distintas de Ollama, o Ollama + OpenAI de reserva) y cambiar cuál está activo sin perder los demás.
Añadir perfil
Clientes
Aíslan datos dentro del universo "archival". Jerarquía real: una API key o un usuario tiene acceso a uno o varios CLIENTES (instalaciones, p.ej. una de Albalá); cada cliente puede tener varios ARCHIVOS internos (ver tabla de abajo, se rellena sola según llegan documentos). Asigna clientes a claves de API o usuarios más abajo (API Keys / Usuarios) -- sin ningún cliente asignado, una clave/usuario ve todo el universo sin restricción.
Archivos
Catálogo de solo lectura -- se rellena automáticamente según llegan documentos etiquetados con un archive_id nuevo dentro de un cliente. No requiere alta manual.
Nuevo usuario
"Usuario": acceso normal al dashboard. "Auditor": ve exactamente lo mismo que un admin (documentos de todos, API keys, perfiles de LLM, clientes, usuarios) pero no puede crear, editar ni borrar nada.