Apri SweetHive

Server agenti aziendali

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

È l'alternativa business all'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 come destinazione aggiuntiva, accanto al tuo Agents Node personale:

  1. In SweetHive web apri My agents 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 con i tuoi agenti, vede solo quello che vedi tu e puoi revocarlo in qualsiasi momento da My agents.

Il server aziendale esegue anche i lavori: i passaggi dei tuoi workflow e le richieste delle app di SweetHive negli hive dell'organizzazione (per esempio la lettura degli scontrini caricati in SweetTimetable). Li segui in My agents, Lavori come qualsiasi altro lavoro.

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 dell'organizzazione: configura un server

  1. Apri Impostazioni, Organizzazioni, scegli la tua organizzazione e vai alla scheda Server agenti (visibile agli amministratori dell'organizzazione).
  2. Crea un server e copia la sua chiave di registrazione - viene mostrata una sola volta.
  3. Scegli come eseguirlo (i link per scaricarlo sono nella stessa scheda):
    • App per macOS o Windows - per un Mac mini, un Mac Studio o una workstation Windows. Scarica l'app per il tuo computer (macOS Apple Silicon, macOS Intel, Windows) e installala.
    • Docker - per un server Linux. Scarica il pacchetto, scompattalo e avvialo (vedi sotto).
  4. Il server appare online nella scheda entro un minuto. Scarica uno o più modelli locali e hai finito: i membri dei tuoi hive possono ora scegliere il server aziendale quando creano un agente.

L'app (macOS, Windows)

Al primo avvio una breve configurazione chiede:

  • una password per la console di amministrazione (almeno 10 caratteri);
  • la chiave di registrazione della scheda Server agenti (puoi anche aggiungerla dopo in Impostazioni, Organizzazione);
  • se la console è raggiungibile solo da questo computer o dalla rete aziendale (in http semplice: in rete mettici davanti un proxy https);
  • dove girano i modelli: su questo computer (il runtime AI è incluso nell'app) o su server Ollama esterni, e il modello predefinito.

Salva la chiave di recupero. Alla fine della configurazione l'app propone la chiave di recupero (disponibile anche dopo in Impostazioni, Sicurezza). Conservala al sicuro: senza di essa i dati degli agenti non si possono recuperare su un computer nuovo o reinstallato.

L'app vive nella barra dei menu / area di notifica, parte con il computer, tiene il computer sveglio mentre serve gli agenti e si aggiorna da sola. L'app per macOS è firmata e notarizzata da Apple; su Windows l'installer non è ancora firmato, quindi la prima volta Windows può mostrare un avviso di SmartScreen (scegli Ulteriori informazioni, Esegui comunque).

Docker (Linux)

tar xzf sweethive-agents-server.tar.gz && cd sweethive-agents-server
cp .env.example .env    # imposta SH_MASTER_KEY e SH_ORG_NODE_KEY
docker compose up -d --build

Apri la console di amministrazione sulla porta 8800, scarica un modello e hai finito. Per aggiornare, scarica il nuovo pacchetto dalla scheda Server agenti ed esegui di nuovo docker compose up -d --build.

Dallo stesso tab vedi stato, versione, utenti ospitati e modelli di ogni server, e puoi revocarlo: smette subito di ricevere nuove installazioni di agenti e nuovi lavori; gli agenti già installati continuano a rispondere finché i proprietari non revocano i loro token.

Aggiornamenti

Il pulsante Aggiorna sulla riga di un server, nella scheda Server agenti, chiede al server di aggiornarsi da solo: l'app scarica la nuova versione e si riavvia entro pochi minuti. Un'installazione Docker scrive la richiesta nel suo log con i comandi per l'IT.

Lettura documenti (SweetTimetable)

Gli scontrini e le fatture caricati in SweetTimetable negli hive dell'organizzazione diventano lavori: quando il computer di un membro non può prenderli, li legge il server aziendale, così nessuno ha bisogno dell'Agents Node per questo. Scegli un modello in grado di leggere le immagini in Impostazioni, Lettura documenti (l'app ne suggerisce uno adatto alla memoria del computer). Il token di SweetTimetable che serviva ai server precedenti alla versione 0.3.0 non è più necessario.

Regola dell'organizzazione: agenti solo sui server aziendali

Nella scheda Server agenti un amministratore dell'organizzazione può decidere che gli hive dell'organizzazione siano leggibili solo da agenti che girano sui server aziendali. Quando la regola è attiva, i membri non possono più mettere sui propri computer personali agenti per quegli hive, e gli agenti già installati su computer personali smettono di vedere quegli hive.

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.