Groupes d'agents
Les groupes d'agents vous permettent d'organiser vos agents par équipe ou par projet, de contrôler finement les accès avec un système de rôles, et de partager des configurations au sein de votre organisation.
#Vue d'ensemble
Un groupe d'agents est un conteneur logique qui regroupe plusieurs agents Claude autour d'un objectif commun — une équipe de développement, une campagne marketing, un environnement de production, etc.
Organisation
Regroupez vos agents par équipe, projet ou environnement pour retrouver ce dont vous avez besoin en un clic.
Contrôle d'accès
Attribuez des rôles précis à chaque agent : Observateur, Éditeur ou Admin. Chaque rôle a des permissions distinctes.
Templates
6 templates prêts à l'emploi (Dev, Marketing, Support…) pour démarrer immédiatement avec les bonnes configurations.
#Créer un groupe
Deux méthodes pour créer un groupe : manuellement ou à partir d'un template.
Création manuelle
Accéder à la page Groupes
Dans la barre de navigation latérale, cliquez sur Groupes.
Cliquer sur « Créer un groupe »
Le bouton se trouve en haut à droite de la page. Une fenêtre modale s'ouvre.
Remplir le formulaire
- Nom du groupe — requis, 100 caractères max
- Description — optionnelle, aide à identifier le groupe
- Partager avec l'organisation — voir la section Partage
Valider
Cliquez sur Créer. Le groupe apparaît immédiatement dans la liste.
Création à partir d'un template
Ouvrir l'onglet Templates
Sur la page Groupes, cliquez sur l'onglet Templates en haut de la liste.
Choisir un template
Parcourez les 6 templates disponibles : Équipe Dev, Marketing, Support Client, Ops & Infrastructure, R&D, Produit.
Utiliser le template
Cliquez sur Utiliser ce template. Un formulaire pré-rempli s'ouvre avec le nom et la configuration du template. Vous pouvez personnaliser le nom avant de confirmer.
#Assigner des agents à un groupe
Un agent peut appartenir à un seul groupe à la fois. L'assignation se fait depuis la fiche du groupe.
Développer la fiche du groupe
Cliquez sur une carte de groupe pour l'expandre et révéler la section membres.
Cliquer sur « Ajouter un agent »
Un panneau de recherche apparaît en dessous de la liste des membres.
Rechercher et sélectionner l'agent
Tapez le nom du projet ou du serveur pour filtrer. Cliquez sur l'agent pour l'ajouter immédiatement avec le rôle Éditeur par défaut.
Changer le rôle si nécessaire
Une fois ajouté, utilisez le sélecteur de rôle en ligne pour passer à Observateur ou Admin.
#Rôles et permissions
Chaque membre d'un groupe se voit attribuer un rôle qui détermine ses droits d'action sur les ressources du groupe.
Peut lire les sessions et les tâches, mais ne peut ni envoyer de messages ni modifier quoi que ce soit. Idéal pour les parties prenantes qui suivent l'avancement.
Accès complet en lecture et écriture sur les sessions et les tâches. C'est le rôle standard pour la plupart des membres actifs.
Tous les droits de l'Éditeur, plus la gestion des membres, la modification des rôles, et la suppression du groupe.
Matrice complète des permissions
| Permission | Observateur | Éditeur | Admin |
|---|---|---|---|
| Lire les sessions | ✅ | ✅ | ✅ |
| Envoyer des messages | — | ✅ | ✅ |
| Modifier les sessions | — | ✅ | ✅ |
| Lire les tâches | ✅ | ✅ | ✅ |
| Créer / modifier des tâches | — | ✅ | ✅ |
| Gérer les membres du groupe | — | — | ✅ |
| Changer les rôles | — | — | ✅ |
| Supprimer le groupe | — | — | ✅ |
#Rôles personnalisés via templates
Les trois rôles de base (Observateur, Éditeur, Admin) couvrent la majorité des cas. Pour des configurations plus spécifiques, les templates personnalisés permettent de définir des surcharges de permissions par ressource.
Créer un template avec permissions personnalisées
Seuls les admins de l'organisation peuvent créer des templates personnalisés via l'API ou l'interface d'administration.
POST /api/agent-group-templates
Content-Type: application/json
{
"name": "Équipe QA",
"description": "Accès lecture seule aux sessions, écriture sur les tâches uniquement",
"icon": "🧪",
"config": {
"defaultRole": "viewer",
"maxMembers": 5,
"permissionOverrides": {
"sessions": ["read"],
"tasks": ["read", "write"]
},
"memberSlots": [
{ "label": "QA Lead", "role": "admin", "required": true },
{ "label": "QA Engineer", "role": "editor", "required": false },
{ "label": "QA Engineer", "role": "editor", "required": false }
]
}
}permissionOverrides — remplace les permissions du rôle par défaut pour cette ressource :
read— accès lecturewrite— lecture + écritureadmin— accès complet incluant suppression
memberSlots — définit des postes nommés avec un rôle imposé, visibles lors de l'assignation d'agents.
isSystem: true sont les 6 templates pré-configurés fournis par Klody. Ils ne peuvent pas être supprimés ni renommés, mais leurs config peuvent être copiées pour créer vos propres variantes.#Templates pré-configurés
Klody inclut 6 templates système, activables en un clic depuis l'onglet Templatesde la page Groupes (ou via POST /api/agent-group-templates/seed).
Équipe Dev
SystèmeProjets logiciels avec un lead technique et plusieurs développeurs.
Marketing
SystèmeCampagnes et contenu — les analystes voient sans modifier.
Support Client
SystèmeÉquipes de support avec un responsable et des agents opérationnels.
Ops & Infrastructure
SystèmeGestion serveurs et infrastructure — permissions élevées par défaut.
R&D
SystèmeRecherche et expérimentation, avec un observateur externe en lecture seule.
Produit
SystèmeRoadmap et fonctionnalités — chaque poste a un rôle adapté à ses responsabilités.
POST /api/agent-group-templates/seedCette opération est idempotente — elle ne recrée pas les templates déjà existants.
#Partage avec l'organisation
Par défaut, un groupe est privé — visible uniquement par son créateur. Activer le partage rend le groupe visible à tous les membres de votre organisation.
🔒 Groupe privé
- • Visible uniquement par le créateur
- • Agents assignés accessibles en dehors du groupe par les autres membres
- • Idéal pour des expérimentations personnelles
🌐 Groupe partagé
- • Visible par tous les membres de l'organisation
- • Badge Partagé affiché sur la carte
- • Seul le créateur / Admin du groupe peut modifier sa configuration
Pour basculer un groupe entre privé et partagé, cliquez sur Modifier dans le menu d'actions du groupe, puis activez ou désactivez le toggle Partager avec l'organisation.
#Exemples pratiques
Exemple 1 — Équipe de développement full-stack
Vous avez 4 agents dédiés à un projet web : un agent backend (Node.js), un agent frontend (React), un agent tests (Jest/Cypress) et un agent DevOps (CI/CD).
Configuration recommandée :
- Créez un groupe « Équipe Dev WebApp » à partir du template 🧑💻 Équipe Dev
- Assignez l'agent backend au slot Tech Lead avec le rôle Admin
- Assignez les agents frontend et tests comme Développeurs avec le rôle Éditeur
- Assignez l'agent DevOps avec le rôle Observateur (il lit les résultats sans modifier)
- Activez le partage avec l'organisation pour que votre équipe puisse suivre l'avancement
Exemple 2 — Environnements séparés (staging / prod)
Vous souhaitez isoler vos agents de production pour éviter les interventions accidentelles.
Configuration recommandée :
- Créez deux groupes distincts : « Production » et « Staging »
- Dans Production : tous les agents en Observateur sauf les responsables en Admin
- Dans Staging : tous les développeurs en Éditeur
- Partagez Staging avec l'organisation, gardez Production privé
Exemple 3 — Audit externe en lecture seule
Un auditeur externe doit pouvoir consulter l'activité des agents sans pouvoir interagir.
- Créez un groupe « Audit Q1 » avec le template 🎧 Support Client
- Assignez les agents concernés avec le rôle Observateur
- Invitez l'auditeur dans votre organisation (page Utilisateurs)
- Ne partagez pas le groupe — l'auditeur verra uniquement ce qui lui est explicitement accordé
#Référence API
Toutes les opérations disponibles dans l'interface sont également accessibles via l'API REST.
/api/agent-groupsLister tous les groupes de l'utilisateur
/api/agent-groupsCréer un groupe
/api/agent-groups/:idDétails d'un groupe
/api/agent-groups/:idModifier nom / description
/api/agent-groups/:idSupprimer un groupe
/api/agent-groups/:id/membersAjouter un agent avec un rôle
/api/agent-groups/:id/membersChanger le rôle d'un membre
/api/agent-groups/:id/membersRetirer un agent du groupe
/api/agent-groups/:id/permissionsMatrice de permissions du groupe
/api/agent-groups/reorderRéordonner groupes et membres
/api/agent-group-templatesLister les templates de l'organisation
/api/agent-group-templatesCréer un template personnalisé (admin)
/api/agent-group-templates/seedInitialiser les 6 templates système (admin)
/api/agent-group-templates/:id/instantiateCréer un groupe à partir d'un template
sessions:admin.