Introducción a SHARA

Qué es SHARA

SHARA es un equipo de IA departamental: un director (Amadeus) recibe tus peticiones, decide qué especialistas las resuelven y te devuelve una sola respuesta consolidada. Cada especialista domina su área —atención al cliente, ventas, marketing, finanzas, RRHH, operaciones, legal, analítica y más— y actúa según las reglas que tú defines en tu identidad corporativa.

A diferencia de un asistente genérico, SHARA está pensada para delegar trabajo operativo real sin perder el control: cada acción con efecto en el mundo (enviar un email, emitir una factura, publicar un post) pasa por tu aprobación humana antes de ejecutarse, y cada decisión queda en un log de auditoría consultable. La promesa no es «un chatbot más listo», sino un equipo que trabaja, documenta lo que hace y te pide permiso para lo importante.

• Un solo interlocutor. Hablas con Amadeus como hablarías con un director de operaciones; él reparte el trabajo internamente.
• On-brand por defecto. Todo lo que produce SHARA sale con tu tono, tus valores y tus reglas, no con una voz neutra de fábrica.
• Con freno de mano. Las acciones sensibles (dinero, contratos, comunicación externa) requieren tu visto bueno; nada se ejecuta a tus espaldas.
• Trazable de extremo a extremo. De la petición al resultado, todo queda registrado: quién pidió qué, qué agente lo resolvió, qué modelo se usó y qué se consumió.

SHARA no sustituye a tu equipo: le quita de encima el trabajo repetitivo y deja a las personas decidir. El humano siempre está en el bucle de las acciones que importan.

Para quién

Para pymes y profesionales sin equipo técnico que quieren delegar tareas operativas en IA sin renunciar al control. Funciona especialmente bien en sectores de oficina con alto volumen de trabajo repetitivo: asesorías y gestorías, consultoras B2B y agencias de marketing y comunicación. Si necesitas que el trabajo quede registrado, revisable y bajo tu visto bueno, SHARA está pensada para ti. Más abajo desarrollamos cada uno de estos tres perfiles.

El flujo de principio a fin

Lo que mejor explica SHARA es seguir una petición desde que sale de tu boca hasta que recibes el resultado. Imagina que escribes a Amadeus: *«Prepara el cierre de tickets de soporte de esta semana y propón un email de seguimiento a los tres clientes con más incidencias.»* Esto es lo que ocurre por debajo, paso a paso:

1. 1 Entrada autenticada. Tu mensaje entra por la API detrás de un JWT firmado. El middleware de tenant fija tu organización como filtro obligatorio: a partir de aquí, ningún dato de otro cliente es accesible.
2. 2 Carga de identidad. Antes de razonar, se inyecta tu identidad corporativa (IDENTITY.md): tono, valores, reglas y restricciones. Todo lo que se produzca a partir de aquí saldrá *on-brand*.
3. 3 Orquestación. Amadeus analiza la petición y la descompone: el resumen de tickets es de Carlzon (atención al cliente) y el email de seguimiento también, con apoyo de Carnegie (ventas) si hay oportunidad comercial. Delega con el contexto necesario y sin filtrar datos entre agentes.
4. 4 Selección de modelo. Un selector elige el *tier* adecuado por alias (Prelude, Sonata, Symphony) según complejidad, horario y cuota disponible. Tú nunca eliges el modelo: lo decide la plataforma.
5. 5 Ejecución con conectores. Los agentes leen de tus herramientas conectadas (helpdesk, CRM, correo) con permisos delegados por OAuth2. Leer es directo; escribir requiere aprobación.
6. 6 Acción → aprobación. El email de seguimiento no se envía: se genera como propuesta y aterriza en tu bandeja de aprobaciones. Tú lo revisas, editas si quieres y apruebas o rechazas.
7. 7 Redacción de salida. Antes de devolverte nada, un redactor revisa la respuesta para evitar filtraciones (por ejemplo, el proveedor real detrás de un alias) y datos sensibles fuera de contexto.
8. 8 Consolidación. Amadeus une los resultados de los agentes en una sola respuesta con tu tono, y te la entrega junto con las acciones pendientes de tu visto bueno.
9. 9 Trazabilidad y consumo. Toda la cadena queda en el log de auditoría (quién, qué, qué agente, qué modelo, antes/después) y el consumo se contabiliza en STU, la unidad única de medida.

El resultado que recibes no es solo el texto: es el texto + las acciones propuestas + el rastro de cómo se llegó a él. Esa trazabilidad es lo que convierte una respuesta de IA en algo que puedes auditar, defender ante un cliente o ante una inspección, y mejorar con el tiempo.

Si prefieres verlo como datos, una petición a un agente y su respuesta tienen esta forma (vista simplificada de la API pública):

# Lanzar una tarea contra el agente de atención al cliente
curl -X POST https://api.shara.aiginer.com/v1/agents/carlzon/run \
  -H "Authorization: Bearer $SHARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Resume los tickets de soporte de esta semana y propon un email de seguimiento a los 3 clientes con mas incidencias.",
    "require_approval": true
  }'

{
  "run_id": "run_8sK2pQ",
  "status": "completed",
  "agent": "carlzon",
  "model_tier": "Sonata",
  "output": {
    "summary": "37 tickets esta semana (-12% vs. anterior). Top motivos: facturacion (14), acceso (9), envios (7).",
    "proposed_actions": [
      {
        "type": "email.draft",
        "approval_id": "apr_4Lm9Zx",
        "status": "pending_approval",
        "to": "cliente@ejemplo.com",
        "subject": "Seguimiento de tus incidencias de esta semana"
      }
    ]
  },
  "usage": { "stu": 142 },
  "audit_log_id": "aud_Qw7Hn1"
}

Fíjate en tres campos: model_tier es siempre un alias (nunca el proveedor real), proposed_actions viene en pending_approval (nada se ejecuta sin ti) y audit_log_id te da la trazabilidad de toda la cadena. Para resolver la aprobación, una petición más:

# Aprobar la accion propuesta (debe hacerlo un humano con scope approvals:write)
curl -X POST https://api.shara.aiginer.com/v1/approvals/apr_4Lm9Zx/accept \
  -H "Authorization: Bearer $SHARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Revisado y aprobado por el responsable de soporte" }'

Las aprobaciones no las puede ejecutar un bot: requieren una credencial de scope approvals:write asociada a una persona. El humano en el bucle es una garantía de diseño, no una opción. Lee API REST y Seguridad.

Lo que diferencia a SHARA

• Amadeus orquesta. No hay agentes sueltos: hay un director que coordina a los departamentales y rinde cuentas a una sola persona.
• Identidad corporativa viva. Tu IDENTITY.md (tono, valores, reglas) se inyecta en cada interacción y se actualiza por parches, nunca por reemplazo total. Cada parche queda en auditoría.
• Modelos públicos, sin lock-in. Trabajas con cuatro modelos por alias —Prelude, Sonata, Symphony y Concerto—. Cuando aparece un motor mejor lo cambiamos por debajo sin que tu equipo re-aprenda nada. Lee Sin lock-in.
• Coste previsible + modo ahorro automático. Una sola unidad de consumo (STU) y cortes de gasto automáticos. Fuera de tu horario laboral, los agentes bajan de modelo para ahorrar.
• Trazabilidad como ciudadano de primera. El log de auditoría no es un extra: es parte del producto. Cada acción con efecto queda registrada con su antes/después.

Tres sectores donde SHARA encaja

SHARA es horizontal —sirve a cualquier pyme de oficina—, pero hay tres perfiles donde el encaje es especialmente directo porque su día a día está lleno de trabajo repetitivo, con tono propio y con necesidad de dejar rastro. Para cada uno: qué les duele y cómo lo cubre el equipo de agentes.

1 · Asesorías y gestorías

Despachos fiscales, laborales, contables y mercantiles con alto volumen de tareas que se repiten cada mes y cada trimestre, y picos brutales en campaña (renta, cierre, modelos trimestrales). El cuello de botella casi nunca es la complejidad: es el volumen y la atención al cliente que lo rodea.

Lo que les suele doler:

• El cierre fiscal mensual y el IVA trimestral consumen horas de trabajo mecánico y repetitivo.
• La atención al cliente se satura en campaña: los mismos correos (documentación pendiente, plazos, recordatorios) una y otra vez.
• El onboarding de nuevos clientes es manual: pedir documentos, montar carpetas, dar de alta, explicar el proceso.

Cómo encaja SHARA: Graham (finanzas) prepara conciliaciones, KPIs y reporting, y deja la emisión de cualquier factura o pago para tu aprobación; Carlzon (atención al cliente) absorbe la avalancha de correos de campaña con triaje por urgencia y respuestas en tu tono; Maslow (RRHH) y Carlzon estructuran el onboarding repetitivo. Como cada documento y cada email salen *on-brand* y todo queda en auditoría, el despacho gana capacidad sin perder el control profesional que su cliente espera. Plan recomendado: Pro.

2 · Consultoras B2B

Consultoras de negocio, IT y management con equipos de 10-50 personas que venden conocimiento y horas. Su producto es la propuesta, el análisis y el entregable, y cualquier minuto que no sea facturable o estratégico es coste puro.

Lo que les suele doler:

• La generación de propuestas comerciales es lenta: cada una se monta casi desde cero aunque el 70 % sea reutilizable.
• El análisis competitivo y estratégico se hace *ad-hoc*, sin un proceso ni un repositorio vivo.
• La gestión de proyectos carece de visibilidad: se detecta tarde que un proyecto va con retraso.

Cómo encaja SHARA: Carnegie (ventas) acelera propuestas reutilizando lo que ya funcionó y lo adapta al cliente; Porter (estrategia) sistematiza el análisis competitivo (cinco fuerzas, mapeo, posicionamiento) y lo mantiene vivo en lugar de empezar de cero cada vez; Rosling (analítica) convierte datos dispersos en reportes con narrativa; y Tracy (PMO, agente adicional) estructura proyectos en hitos con detección temprana de retrasos. El consultor dedica su tiempo a pensar y vender, no a maquetar documentos. Plan recomendado: Max.

3 · Agencias de marketing y comunicación

Agencias creativas, de performance, social media y RRPP que llevan varios clientes a la vez, cada uno con su marca, su tono y su calendario. El reto no es la falta de ideas: es producir a escala manteniendo cada marca distinta y reportar sin que se coma el margen.

Lo que les suele doler:

• Generar contenido on-brand a escala para varios clientes sin que todo «suene igual».
• El reporting mensual a cliente es repetitivo y consume horas no facturables.
• Coordinar el calendario editorial multi-cliente sin que se solapen ni se caigan publicaciones.

Cómo encaja SHARA: aquí brilla la identidad corporativa viva. Cada cliente de la agencia puede tener su propia identidad, de modo que Kotler (marketing) y Bernays (comunicación) producen posts, newsletters y notas de prensa que suenan a *esa* marca y no a una voz genérica; Rosling (analítica) automatiza el reporting mensual con narrativa; y Tracy (PMO) coordina el calendario editorial multi-cliente. La aprobación humana garantiza que nada se publica sin el visto bueno del responsable de cuenta. Plan recomendado: Pro (o Max si la agencia quiere a Bernays para comunicación).

SHARA está orientada a sectores de oficina con trabajo repetitivo. No está diseñada para entornos de alto riesgo regulatorio como farma. Lee el catálogo de agentes para ver los 21 disponibles.

De cero a tu primera conversación

1. 1 Crea la cuenta en shara.aiginer.com y elige plan. Recibes por correo tu clave de empresa con formato SHARA-XXXX-XXXX-XXXX-XXXX.
2. 2 Activa la empresa: nombre comercial, sector, tamaño del equipo y horario laboral (fuera de él se aplica modo ahorro). Verificas el correo del admin, defines zona horaria (por defecto Europe/Madrid) y aceptas el DPA.
3. 3 Invita a tu primer empleado desde Equipo, con su rol y departamentos. Solo el CEO o quien tenga permiso habla con Amadeus; cada empleado conversa con su agente.
4. 4 Conecta tus herramientas (correo, calendario, CRM, ERP) por OAuth2 estándar. Lee Conectores.
5. 5 Habla con Amadeus. Por ejemplo: *«Dame un resumen ejecutivo del último mes: ventas cerradas, pipeline abierto, tickets pendientes y alertas financieras.»* Amadeus delega y consolida la respuesta.

Una vez dentro, el día a día tiene dos modos: la app de escritorio (recomendada, con notificaciones nativas y la bandeja de aprobaciones a mano) y la API REST para integrar SHARA en tus propios flujos. Un ejemplo mínimo en Python para consultar el consumo del mes:

import os, requests

BASE = "https://api.shara.aiginer.com/v1"
headers = {"Authorization": f"Bearer {os.environ['SHARA_TOKEN']}"}

# Consumo STU del mes en curso
usage = requests.get(f"{BASE}/usage/current", headers=headers).json()
print(f"STU consumidos este mes: {usage['stu_used']} / {usage['stu_quota']}")

# Aprobaciones pendientes de tu visto bueno
pending = requests.get(f"{BASE}/approvals", headers=headers).json()
print(f"Acciones esperando aprobacion: {len(pending['items'])}")

Self-serve en First y Pro; onboarding acompañado en Max y Plan Local. ¿Dudas durante el arranque? Escribe a soporte@aiginer.com.

Por dónde seguir

Esta página es el mapa. A partir de aquí, según lo que quieras entender:

• Arquitectura — las cuatro capas (Cliente, API, Orquestación, Datos) y los cuatro tiers de modelo.
• Catálogo de agentes — Amadeus + los 20 especialistas, qué hace cada uno y en qué plan.
• Conectores — qué herramientas puedes enchufar (correo, chat, calendario, CRM, ERP) y cómo.
• STU y cuotas — cómo se mide el consumo, qué es un STU y cómo funcionan los cortes de gasto.
• Sin lock-in — por qué trabajas con alias de modelo y nunca quedas atado a un proveedor.
• Seguridad — aislamiento multi-tenant, aprobaciones, auditoría y cómo protegemos tus datos.
• API REST — autenticación, endpoints, webhooks firmados y SDKs para integrar SHARA.
• Plan Local — SHARA sobre tu propia infraestructura con el motor Concerto.
• Glosario — los términos de SHARA (tenant, STU, identidad, tier, orquestador) en una página.