# Server agenti aziendali

Il **SweetHive Agents Server** permette a un'azienda di eseguire gli agenti AI
di tutta l'organizzazione **sui propri server**. Una sola macchina, gestita
dal team IT, ospita gli agenti di tutti i membri degli hive
dell'organizzazione: nessuno installa nulla sul proprio computer e
l'inferenza non esce mai dalla rete aziendale.

È l'alternativa business all'[Agents Node](agents-node) personale: edge
computing più SaaS - la collaborazione resta nel cloud SweetHive,
l'intelligenza e i dati che elabora restano su hardware di proprietà
dell'azienda.

> **Solo piani Organizzazione.** I server agenti aziendali sono disponibili
> sui piani Organizzazione, per gli hive di proprietà dell'organizzazione.
> Il software si distribuisce esclusivamente dal pannello impostazioni
> dell'organizzazione.

## Per i membri: metti il tuo agente sul server aziendale

Se la tua organizzazione ha un server agenti, lo vedrai nella finestra
[Collega un agente](connect-an-agent) come destinazione aggiuntiva, accanto
al tuo Agents Node personale:

1. In SweetHive web apri **I miei agenti** e scegli **Collega un agente**.
2. Seleziona il **server aziendale** come destinazione (mostra quanti agenti
   puoi ancora ospitare lì - ogni membro ha una dotazione stabilita dal
   piano Organizzazione).
3. Crea l'agente come sempre. Si installa da solo sul server aziendale e va
   online in circa mezzo minuto. Niente da scaricare.

Il tuo agente funziona esattamente come uno sul tuo computer: risponde nelle
chat, vede solo quello che vedi tu e puoi revocarlo in qualsiasi momento da
I miei agenti.

**I tuoi dati restano tuoi.** Sul server, l'agente di ogni utente gira in
uno spazio isolato, cifrato con chiavi dedicate a quell'utente.
Conversazioni, token e memoria di utenti diversi non si mescolano mai, e la
console IT mostra solo dati operativi - mai i contenuti dei messaggi.

## Per gli amministratori: configura un server

1. Apri **Impostazioni, Organizzazioni**, scegli la tua organizzazione e vai
   alla scheda **Server agenti** (visibile agli amministratori).
2. **Crea un server** e copia la chiave di registrazione - viene mostrata
   una sola volta.
3. **Scarica il pacchetto** (link nella stessa scheda) su una macchina
   aziendale: un server Linux qualsiasi con Docker; una GPU è consigliata
   per modelli più veloci.
4. Scompatta, imposta la chiave nella configurazione e avvia:

   ```bash
   cp .env.example .env    # imposta SH_MASTER_KEY e SH_ORG_NODE_KEY
   docker compose up -d
   ```

5. Il server appare **online** nella scheda entro un minuto. Scarica uno o
   più modelli locali dalla sua console di amministrazione e hai finito: i
   membri dei tuoi hive possono ora scegliere il server aziendale quando
   creano un agente.

Dalla stessa scheda vedi stato, versione, utenti ospitati e modelli di ogni
server, e puoi **revocarlo**: smette subito di ricevere nuove installazioni;
gli agenti già installati continuano a rispondere finché i loro token non
vengono revocati dai proprietari.

## Limiti e privacy

- **Dotazione per membro.** Il piano Organizzazione stabilisce quanti agenti
  ogni membro può ospitare sui server aziendali. La procedura guidata mostra
  la dotazione e il server la applica.
- **Perimetro garantito.** Ogni agente si autentica con il token con ambito
  del suo proprietario: vede esattamente i contesti concessi, con la
  visibilità del proprietario, mai di più.
- **Isolato per utente.** Token e memoria delle conversazioni sono cifrati
  per utente sul server; i dati di utenti diversi non si mescolano mai.
- **Gli admin gestiscono la capacità, non i contenuti.** La console IT
  espone stato, modelli e contatori. Non ha accesso a conversazioni o
  messaggi.