Glosario

Un vocabulario común para entender la documentación de Shara, ordenado por bloques temáticos. Cada término enlaza, cuando aplica, con la guía donde se desarrolla a fondo. Si echas en falta algún concepto, escríbenos a soporte@aiginer.com.

El glosario está dividido en bloques: consumo y facturación, agentes y orquestación, modelos, seguridad y control, integración (API, webhooks, conectores) y operación (multi-tenant, auditoría, licencias). Los términos marcados con un enlace tienen una guía dedicada; el resto se define aquí de forma autocontenida.

Consumo y facturación

Shara factura por consumo abstracto: nunca pagas «tokens de un proveedor», sino una unidad propia y estable. Esto desacopla tu factura del modelo concreto que se use por debajo y de los cambios de precio del mercado.

Término	Definición
STU (Shara Token Units)	La unidad única de consumo del cliente, independiente del modelo usado por debajo: 1 STU = 1 token ponderado; la salida pesa más que la entrada y los modelos más capaces pesan más por token. Toda la actividad de los agentes (razonamiento, llamadas a herramientas, generación) se cuenta en STU. Pagas STU, no tokens de un proveedor concreto. Ver STU y cuotas.
Cuota	El volumen de STU incluido en tu plan cada ciclo mensual. Mientras consumes dentro de la cuota no hay cargos adicionales. La cuota se renueva al inicio de cada periodo de facturación.
Excedente	Los STU consumidos por encima de la cuota mensual en los planes en la nube, a 5 € por millón de STU. Concerto Local no tiene excedente. Para limitarlo, puedes editar los topes de gasto.
Rollover	Traslado de STU no consumidos al mes siguiente, con un techo del 20 % de la cuota base. Los STU trasladados caducan a los 2 meses. Solo se aplica a los planes en la nube; Concerto Local no tiene rollover porque su cuota en la nube es una bolsa fija. Detalle en STU y cuotas.
Modo ahorro	Un modo que baja automáticamente el alias de modelo un escalón (Symphony a Sonata, Sonata a Prelude) fuera de tu horario laboral en los planes en la nube, y también a partir del 130 % de tu cuota. Concerto Local nunca baja de modelo.
Self-paying API	El mecanismo por el que Shara paga el uso de los modelos por ti y te lo presenta consolidado en STU. Tú no gestionas claves de proveedores ni saldos externos.

Regla mental: cuota es lo que ya pagaste, excedente es lo que pagas de más si te pasas, y rollover es lo que rescatas de un mes flojo. Los topes de gasto son el freno que evita sorpresas.

Agentes y orquestación

Shara no es un único chatbot: es un equipo de agentes especializados coordinados por un orquestador. Cada persona habla con el agente que le toca por su rol, y Amadeus coordina entre ellos. Ver Agentes.

Término	Definición
Amadeus / orquestador	El agente que coordina al equipo. Recibe una petición que cruza varios departamentos, decide qué especialistas intervienen, delega y consolida una sola respuesta. Está en todos los planes. Los owner y administradores hablan con él directamente; cada empleado habla con el agente de su propio departamento.
Agente departamental	Cada uno de los 20 especialistas (Wanamaker, Patterson, Graham…) que cubren un área de la empresa (ventas, atención al cliente, finanzas, legal, etc.). Tu plan decide cuántos tienes: eliges 5, 10 o 15 de los 15 agentes a elegir (First, Pro, Max), y desde Max se pueden añadir 5 más. Ver Agentes.
escalate_to_amadeus	La herramienta de escalado: cuando un agente departamental detecta que una petición excede su ámbito o necesita a otro departamento, se la devuelve a Amadeus. La coordinación entre agentes pasa siempre por Amadeus.
Run (ejecución)	Una ejecución individual de un agente: una llamada con su entrada, su contexto, las herramientas que usa y su salida. Cada ejecución se cuenta en STU y queda registrada. Una sola conversación puede generar varias ejecuciones encadenadas.
IDENTITY.md	La identidad corporativa (tono, valores, reglas de marca, qué sí y qué no) que se añade a cada tarea. Cambia por parche incremental (se añaden reglas o se reemplaza una sección) y nunca por sustitución completa. Ver Identidad del agente.
Memoria	Las notas que Shara guarda entre conversaciones, en cuatro ámbitos: empresa, departamento, agente y personal. Está incluida en todos los planes. Ver Memoria.
Flujo	Una automatización reutilizable paso a paso, hecha de nodos (entrada, datos, IA, lógica y salida). En la aplicación aparece como Automatizaciones. Ver Flujos.
Rol	Lo que una persona puede ver, aprobar y cambiar: owner, administrador, director, operador, IT o visualizador. Ver Roles y permisos.
Aprobaciones	La bandeja de aprobación humana. Cualquier acción con efecto fuera de Shara (enviar un correo, pagar, cambiar datos externos) queda pendiente de tu visto bueno. Si nadie decide, la conversación queda en espera hasta 7 días; después la petición caduca y la acción no se ejecuta. Ver Aprobaciones y auditoría.

Modelos (alias) y sin lock-in

Shara nunca expone el proveedor real detrás de un modelo. Trabaja con alias estables que abstraen potencia y coste, de modo que podemos cambiar de proveedor por debajo sin que tu integración ni tu factura se enteren. Ver Sin dependencia de proveedor.

Alias	Para qué sirve
Prelude	Nivel ligero y barato. Tareas rápidas, clasificación, extracciones simples, respuestas cortas. El más barato en STU. Disponible en todos los planes.
Sonata	Nivel equilibrado. El caballo de batalla de la mayoría de las tareas de oficina: redacción, resúmenes, atención estándar. Disponible desde Pro.
Symphony	Nivel alto. Razonamiento complejo, análisis de varios pasos, tareas que necesitan más contexto y precisión. Disponible desde Max, y en el modo híbrido de Concerto Local.
Concerto	El modelo que se ejecuta en local, en el plan Concerto Local (on-premise). Es un solo modelo, de primer nivel, que corre en tu servidor. La inferencia local no usa la cuota en la nube.

Término	Definición
Alias de modelo	El nombre público de un modelo (Prelude, Sonata, Symphony, Concerto). Oculta al proveedor real, evita el lock-in y permite a Shara optimizar coste y calidad sin romper tu integración. El proveedor nunca es una opción. En la aplicación, Shara elige el alias según tu plan, tu horario laboral y tu cuota. Por la API eliges tú el alias, hasta el techo de tu plan; si pides uno superior, responde 422 alias_plan_mismatch.
Sin lock-in	La garantía de que no quedas atado a un proveedor. Como solo ves alias, Shara puede sustituir el motor de debajo por uno mejor o más barato sin que cambie nada de tu lado. Ver Sin dependencia de proveedor.

Seguridad y control de gasto

El control no es opcional: Shara está diseñada para que nada importante se ejecute sin supervisión y el gasto nunca se dispare sin un freno. Ver Seguridad y cumplimiento.

Término	Definición
Topes de gasto (kill-switch)	Un corte de gasto automático y de varios niveles: por ejecución, por hora y por día. Por defecto son 1 M, 10 M y 80 M de STU. Si una ejecución (o una cadena de ellas) se pasa, Shara la detiene y responde 429 kill_switch. Un owner o administrador puede editar cada tope o desactivarlo. Ver Aprobaciones y auditoría.
Registro de auditoría	El registro de acciones de tu empresa: quién hizo qué, sobre qué recurso, con el antes y el después. Cada registro se encadena con un hash SHA-256 al anterior, de modo que una comprobación puede detectar que se alteró un registro intermedio. Ver Aprobaciones y auditoría.
DPA	Acuerdo de encargo de tratamiento de datos (artículo 28 del RGPD). Es el contrato que regula cómo trata Shara los datos por cuenta de tu organización. Está incluido en todos los planes y se firma a medida en Max y Concerto Local. Ver el DPA.

Integración: API pública

La API pública es la superficie que usa un desarrollador externo para integrar Shara con sus sistemas. Se autentica con una API key y aplica límites de uso. Ver API REST y Conectores.

Término	Definición
API key	La credencial que autentica tus llamadas a la API de Shara. Empieza por shara_sk_live_, se emite por espacio de trabajo, se envía en la cabecera Authorization, se puede revocar y rotar, y nunca debe exponerse en código de cliente ni en repositorios. Una API key solo sirve en POST /v1/inference y en el puente MCP; todo lo demás pide una sesión iniciada.
Límite de ritmo (rate limit)	El límite de peticiones por minuto que protege el servicio: 60 por IP y ruta, y 600 por espacio de trabajo y ruta. Si lo superas, la API responde 429.
Idempotencia	La garantía de que reenviar la misma petición no la duplica. Identificas el evento con un id único (por ejemplo X-SHARA-Event-Id); si Shara ya lo procesó, devuelve el resultado anterior en lugar de ejecutarlo otra vez.

Una llamada que funciona hoy, con una API key:

curl -X POST https://api.sharasaas.com/v1/inference \
  -H "Authorization: Bearer shara_sk_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "alias": "Sonata",
    "agentSlug": "amadeus",
    "messages": [
      { "role": "user", "content": "Resume el último ticket de soporte y sugiere una respuesta." }
    ]
  }'

La respuesta ya trae el resultado (content) y cómo terminó el turno (status). Todos los campos están en la página de la API REST.

Integración: webhooks

Shara todavía no ofrece webhooks entrantes. Mira Webhooks para saber qué puedes hacer hoy.

Integración: conectores

Término	Definición
Conector	Una forma concreta de conectar Shara con tus sistemas: Desktop Agent, Server Agent y MCP gateway. Cada conector aporta su propia autenticación y sus garantías de aislamiento. Ver Conectores.
Conector universal	El enfoque general: Shara ofrece un camino genérico para integrar sistemas sin desarrollo a medida, combinando los conectores anteriores. Los conectores universales (Gmail, Outlook, Slack, Teams, Calendar, Drive, Holded y más) están en todos los planes; HubSpot y Pipedrive están disponibles desde Pro.

Operación: multi-tenant y licencias

Término	Definición
Tenant (multi-tenant)	Tu organización cliente. Shara es multi-tenant: una sola plataforma atiende a muchos clientes con aislamiento estricto de los datos. Cada consulta se filtra por empresa y, en trece áreas (consumo de modelos, facturación, aprobaciones, lectura de memoria, ejecuciones, flujos, integraciones, recursos humanos, proyectos, soporte, facturación fiscal, plantillas de documentos y clientes, el CRM), la base de datos añade además sus propias políticas de fila. Los datos, las API keys y el consumo de STU de un tenant nunca se mezclan con los de otro.
Servicio de licencias	El servicio que valida la licencia de Concerto Local. La instalación lo consulta cada 24 horas. La licencia vale 7 días y se renueva a diario. Si no puede conectar, hay 30 días de gracia con todo normal y un aviso; pasados, solo se puede leer y exportar hasta que vuelva la conexión. Las licencias se firman con Ed25519, así que se pueden verificar sin contactar con el servidor.
Concerto Local / on-premise	El despliegue de Shara en tu propia infraestructura (tus servidores o tu nube privada), en lugar de la nube gestionada, con precio a medida. La base de datos, los agentes y la inferencia de Concerto corren en tu hardware. Tiene dos modos: solo local (todo con Concerto) e híbrido (Amadeus usa Symphony en la nube de la UE, con una bolsa fija de 60 M de STU al mes que enciendes y apagas desde la consola, sin excedente ni rollover). Ver Concerto Local.

¿Buscas un concepto con más profundidad? Empieza por Qué es Shara, STU y cuotas, API REST o Conectores.