Gérer les talents de l’organisation

Les Talents Custom ajoutent aux Talents Grace des règles propres à votre organisation : contraintes réglementaires, conventions internes ou pratiques qui ne doivent pas être publiées dans le catalogue partagé.

Les talents publiés sont visibles dans le Catalogue par tous les membres de l’organisation active. Leur contenu reste limité à cette organisation et aux projets qui lui appartiennent. Seuls les owners et admins peuvent les créer ou les gérer depuis Catalogue → Créer un talent d’organisation ou Organisation → Talents de l’organisation → Nouveau talent.

Choisir le mode d’application

Lors de la migration vers ces deux modes, les anciens talents Selon la tâche deviennent optionnels. Aucun projet ne les sélectionne automatiquement : choisissez explicitement les projets qui en ont besoin.

Préparer un brouillon avec votre agent IA

Un owner ou un admin peut demander explicitement à son agent IA de créer un talent d’organisation. L’outil grace_create_organization_talent n’apparaît qu’après une connexion OAuth autorisée sur le projet courant ; il n’est pas proposé aux membres ni aux clés API de projet.

L’agent IA vous aide alors à produire une seule règle cohérente :

1. il précise avec vous le résultat attendu, la portée, les interdictions, les exceptions et la vérification observable ;
2. il propose le mode Optionnel pour les projets par défaut et réserve le mode obligatoire à une règle explicitement universelle ;
3. il affiche le nom, la consigne, le mode et les déclencheurs exacts ;
4. il attend votre accord explicite sur cet ensemble avant l’enregistrement.

L’appel enregistre uniquement un brouillon dans l’organisation propriétaire du projet connecté. Il ne permet pas de choisir une autre organisation et n’active jamais le talent. Ouvrez ensuite Organisation → Talents de l’organisation pour le relire et le publier.

Créer et activer un talent

Le parcours distingue clairement l’enregistrement du brouillon de son activation :

1. Depuis le Catalogue, sélectionnez Créer un talent d’organisation ; ou ouvrez Organisation → Talents de l’organisation, puis Nouveau talent.
2. À l’étape Rédiger, donnez-lui un nom explicite, rédigez une consigne directement applicable par un agent IA et choisissez son mode d’application.
3. Sélectionnez Enregistrer le brouillon et continuer. Le talent est alors conservé, mais il n’est pas encore transmis aux nouvelles tâches.
4. À l’étape Vérifier et activer, contrôlez la consigne et sa portée.
5. Pour le mode Optionnel pour les projets, examinez les mots-clés proposés par Grace, corrigez-les si nécessaire, puis confirmez la liste. Un mot-clé contient au maximum 80 caractères.
6. Pour le mode Obligatoire pour tous les projets, confirmez explicitement que le talent doit s’appliquer automatiquement à tous les projets de l’organisation.
7. Sélectionnez Activer le talent.

Une confirmation indique alors que le talent actif apparaît dans le catalogue de l’organisation avec sa version publiée et son mode d’application. Un brouillon n’apparaît pas dans le catalogue et n’est jamais transmis aux agents IA.

Consulter un talent publié

Depuis le Catalogue, sélectionnez la carte Votre organisation, comme pour un Talent Grace. La fiche affiche son but, sa version et son mode d’application. Elle n’expose ni la consigne d’exécution ni ses déclencheurs : Grace les transmet uniquement aux agents IA autorisés des projets concernés. Les owners et admins retrouvent le contenu complet dans Organisation → Talents de l’organisation, avec les actions de gestion qui leur sont réservées.

Sélectionner un talent dans un projet

Ouvrez le Catalogue depuis le projet concerné :

• un talent optionnel peut être coché puis installé comme un talent Grace ;
• un talent obligatoire est déjà coché et verrouillé, car il s’applique sans configuration du projet ;
• la carte Votre organisation affiche la version publiée et le mode qui gouverne la sélection.

Rechercher et filtrer

La page réunit la recherche et le filtre de statut dans une seule barre. Les quatre statuts Tous, Actifs, Brouillons et Désactivés affichent les effectifs correspondants. La recherche et le statut sélectionné restent inscrits dans l’URL pour conserver la vue lors d’un retour ou d’un partage interne.

Modifier un talent actif

Sélectionnez Gérer sur le talent concerné. L’écran distingue les actions suivantes :

• Enregistrer les modifications crée une version de travail ; la version active reste inchangée.
• Publier les modifications remplace la version active pour les nouvelles tâches.
• Activer le talent rend un brouillon disponible.
• Réactiver le talent remet un talent désactivé à disposition.

Une seule action principale est proposée à chaque étape. Si un autre administrateur a modifié le talent entre-temps, Grace conserve vos saisies et présente une comparaison avec la dernière version enregistrée. Vous pouvez remplacer vos saisies ou réessayer avec vos modifications.

Désactiver ou réactiver

La désactivation est isolée dans une zone de danger et demande une confirmation explicite :

• Désactiver le talent le retire immédiatement des nouvelles résolutions, sans supprimer son historique.
• Réactiver le talent republie la version approuvée et la rend de nouveau disponible.
• Les tâches, résolutions et rapports de validation historiques gardent la version exacte qui leur était associée.

Archiver un talent désactivé

Dans Désactivés, ouvrez Gérer, puis Archiver le talent. Terminez ou annulez les modifications en cours avant d’archiver.

Le talent disparaît des listes courantes et se retrouve dans Archivés. Ses versions et l’historique des tâches restent conservés. Depuis Archivés → Gérer, Restaurer le talent le remet dans Désactivés : il ne sera pas utilisé tant que vous ne l’aurez pas réactivé.

Un talent actif doit d’abord être désactivé. L’archivage ne supprime aucune donnée et reste réservé aux propriétaires et administrateurs de l’organisation.

Ce que reçoit l’agent

grace_prepare_task renvoie un resolutionId. Cette référence fige les Talents Grace servis et la version exacte de chaque Talent Custom transmis pour la tâche. L’agent la transmet ensuite à grace_review, puis enregistre avec grace_record_validation les verdicts des règles vérifiables des Talents Grace et de chaque Talent Custom.

Une clé API utilisée par une automatisation doit recevoir des droits distincts :

• validate pour lire le plan de revue ;
• record_validation uniquement si elle doit enregistrer les verdicts de revue.

Voir Appeler Grace depuis un hook pour les exemples et les règles de moindre privilège.