# Servidores de agentes de empresa

El **SweetHive Agents Server** permite a una empresa ejecutar los agentes de
IA de toda la organización **en sus propios servidores**. Una sola máquina,
gestionada por el equipo de TI, aloja los agentes de todos los miembros de
los hives de la organización: nadie instala nada en su ordenador y la
inferencia nunca sale de la red de la empresa.

Es la alternativa business al [Agents Node](agents-node) personal: edge
computing más SaaS - la colaboración se queda en la nube de SweetHive, la
inteligencia y los datos que procesa se quedan en hardware propiedad de la
empresa.

> **Solo planes Organización.** Los servidores de agentes de empresa están
> disponibles en los planes Organización, para los hives propiedad de la
> organización. El software se distribuye exclusivamente desde el panel de
> ajustes de la organización.

## Para los miembros: pon tu agente en el servidor de la empresa

Si tu organización tiene un servidor de agentes, lo verás en la ventana
[Conectar un agente](connect-an-agent) como ubicación adicional, junto a tu
Agents Node personal:

1. En SweetHive web abre **Mis agentes** y elige **Conectar un agente**.
2. Selecciona el **servidor de la empresa** como ubicación (muestra cuántos
   agentes puedes alojar todavía allí - cada miembro tiene un cupo definido
   por el plan Organización).
3. Crea el agente como siempre. Se instala solo en el servidor de la empresa
   y se pone en línea en medio minuto aproximadamente. Nada que descargar.

Tu agente funciona exactamente igual que uno en tu propio ordenador:
responde en tus chats, ve solo lo que tú ves y puedes revocarlo en cualquier
momento desde Mis agentes.

**Tus datos siguen siendo tuyos.** En el servidor, el agente de cada usuario
se ejecuta en su propio espacio aislado, cifrado con claves dedicadas a ese
usuario. Las conversaciones, los tokens y la memoria de distintos usuarios
nunca se mezclan, y la consola de TI muestra solo datos operativos - nunca
el contenido de los mensajes.

## Para administradores: configurar un servidor

1. Abre **Ajustes, Organizaciones**, elige tu organización y ve a la pestaña
   **Servidores de agentes** (visible para los administradores).
2. **Crea un servidor** y copia su clave de registro - se muestra una sola
   vez.
3. **Descarga el paquete** (enlace en la misma pestaña) en una máquina de la
   empresa: cualquier servidor Linux con Docker; se recomienda una GPU para
   modelos más rápidos.
4. Descomprime, define la clave en la configuración y arranca:

   ```bash
   cp .env.example .env    # define SH_MASTER_KEY y SH_ORG_NODE_KEY
   docker compose up -d
   ```

5. El servidor aparece **en línea** en la pestaña en menos de un minuto.
   Descarga uno o más modelos locales desde su consola de administración y
   listo: los miembros de tus hives ya pueden elegir el servidor de la
   empresa al crear un agente.

Desde la misma pestaña ves el estado, la versión, los usuarios alojados y
los modelos de cada servidor, y puedes **revocarlo**: deja de recibir nuevas
instalaciones de inmediato; los agentes ya instalados siguen respondiendo
hasta que sus propietarios revoquen sus tokens.

## Límites y privacidad

- **Cupo por miembro.** El plan Organización define cuántos agentes puede
  alojar cada miembro en los servidores de la empresa. El asistente muestra
  el cupo y el servidor lo aplica.
- **Alcance garantizado.** Cada agente se autentica con el token de alcance
  limitado de su propietario: ve exactamente los contextos concedidos, con
  la visibilidad del propietario, nunca más.
- **Aislado por usuario.** Los tokens y la memoria de las conversaciones se
  cifran por usuario en el servidor; los datos de distintos usuarios nunca
  se mezclan.
- **Los admins gestionan capacidad, no contenido.** La consola de TI expone
  estado, modelos y contadores. No tiene acceso a conversaciones ni
  mensajes.