# Serveurs d'agents d'entreprise

Le **SweetHive Agents Server** permet à une entreprise d'exécuter les agents
IA de toute son organisation **sur ses propres serveurs**. Une seule machine,
gérée par l'équipe IT, héberge les agents de tous les membres des hives de
l'organisation : personne n'installe quoi que ce soit sur son ordinateur et
l'inférence ne quitte jamais le réseau de l'entreprise.

C'est l'alternative business à l'[Agents Node](agents-node) personnel : edge
computing plus SaaS - la collaboration reste dans le cloud SweetHive,
l'intelligence et les données qu'elle traite restent sur du matériel
appartenant à l'entreprise.

> **Plans Organisation uniquement.** Les serveurs d'agents d'entreprise sont
> disponibles sur les plans Organisation, pour les hives appartenant à
> l'organisation. Le logiciel est distribué exclusivement depuis le panneau
> de paramètres de l'organisation.

## Pour les membres : placez votre agent sur le serveur d'entreprise

Si votre organisation exploite un serveur d'agents, vous le verrez dans la
fenêtre [Connecter un agent](connect-an-agent) comme emplacement
supplémentaire, à côté de votre Agents Node personnel :

1. Dans SweetHive web, ouvrez **Mes agents** et choisissez **Connecter un
   agent**.
2. Sélectionnez le **serveur d'entreprise** comme emplacement (il indique
   combien d'agents vous pouvez encore y héberger - chaque membre dispose
   d'un quota défini par le plan Organisation).
3. Créez l'agent comme d'habitude. Il s'installe tout seul sur le serveur
   d'entreprise et passe en ligne en une trentaine de secondes. Rien à
   télécharger.

Votre agent fonctionne exactement comme un agent sur votre propre
ordinateur : il répond dans vos chats, ne voit que ce que vous voyez et vous
pouvez le révoquer à tout moment depuis Mes agents.

**Vos données restent les vôtres.** Sur le serveur, l'agent de chaque
utilisateur s'exécute dans son propre espace isolé, chiffré avec des clés
dédiées à cet utilisateur. Conversations, jetons et mémoire de différents
utilisateurs ne sont jamais mélangés, et la console IT n'affiche que des
données opérationnelles - jamais le contenu des messages.

## Pour les administrateurs : configurer un serveur

1. Ouvrez **Paramètres, Organisations**, choisissez votre organisation et
   allez dans l'onglet **Serveurs d'agents** (visible pour les
   administrateurs).
2. **Créez un serveur** et copiez sa clé d'enrôlement - elle n'est affichée
   qu'une seule fois.
3. **Téléchargez le paquet** (lien dans le même onglet) sur une machine de
   l'entreprise : n'importe quel serveur Linux avec Docker ; un GPU est
   recommandé pour des modèles plus rapides.
4. Décompressez, définissez la clé dans la configuration et démarrez :

   ```bash
   cp .env.example .env    # définissez SH_MASTER_KEY et SH_ORG_NODE_KEY
   docker compose up -d
   ```

5. Le serveur apparaît **en ligne** dans l'onglet en moins d'une minute.
   Téléchargez un ou plusieurs modèles locaux depuis sa console
   d'administration et c'est terminé : les membres de vos hives peuvent
   désormais choisir le serveur d'entreprise lorsqu'ils créent un agent.

Depuis le même onglet, vous voyez l'état, la version, les utilisateurs
hébergés et les modèles de chaque serveur, et vous pouvez le **révoquer** :
il cesse immédiatement de recevoir de nouvelles installations ; les agents
déjà installés continuent de répondre tant que leurs jetons ne sont pas
révoqués par leurs propriétaires.

## Limites et confidentialité

- **Quota par membre.** Le plan Organisation définit combien d'agents chaque
  membre peut héberger sur les serveurs de l'entreprise. L'assistant affiche
  le quota et le serveur l'applique.
- **Périmètre garanti.** Chaque agent s'authentifie avec le jeton à portée
  limitée de son propriétaire : il voit exactement les contextes accordés,
  avec la visibilité du propriétaire, jamais plus.
- **Isolé par utilisateur.** Jetons et mémoire des conversations sont
  chiffrés par utilisateur sur le serveur ; les données de différents
  utilisateurs ne sont jamais mélangées.
- **Les admins gèrent la capacité, pas le contenu.** La console IT expose
  l'état, les modèles et des compteurs. Elle n'a aucun accès aux
  conversations ni aux messages.