Grace
Guides

Gérer les talents de l’organisation

Créer, vérifier, publier et désactiver les talents propres à votre organisation.

Les talents de l’organisation ajoutent aux talents du catalogue des règles propres à votre organisation : contraintes réglementaires, conventions internes ou pratiques qui ne doivent pas être publiées dans le catalogue partagé. L’API les conserve sous le nom d’« expertises privées ».

Ils sont accessibles aux owners et admins de l’organisation active depuis Organisation → Talents de l’organisation. Leur contenu reste limité à cette organisation et aux projets qui lui appartiennent.

Choisir le mode d’application

ModeQuand l’utiliserEffet pendant grace_prepare_task
Selon la tâcheLe talent ne concerne que certaines tâches.Grace le transmet lorsque ses mots-clés correspondent à la tâche ou lorsque la pertinence sémantique le retient.
Pour toutes les tâchesLe talent doit s’appliquer à toutes les tâches, sans exception.Grace le transmet toujours. Il peut dépasser le budget de contexte plutôt que d’être supprimé.

Un talent appliqué à toutes les tâches augmente chaque contexte résolu pour les projets de l’organisation. Réservez ce mode aux obligations réellement universelles et gardez la consigne concise.

Créer et activer un talent

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

  1. 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 assistant 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 Selon la tâche, 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 Pour toutes les tâches, confirmez explicitement que le talent doit être transmis à toutes les tâches de l’organisation.
  7. Sélectionnez Activer le talent.

Une confirmation indique alors que le talent est disponible pour les nouvelles tâches selon son mode d’application. Un brouillon n’est jamais transmis aux assistants.

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.

Ce que reçoit l’agent

grace_prepare_task renvoie un resolutionId. Cette référence fige les talents du catalogue et les versions privées transmis pour la tâche. L’agent la transmet ensuite à grace_validate, puis enregistre un verdict pour chaque expertise privée avec grace_record_validation.

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

  • validate pour lire le playbook d’audit ;
  • record_validation uniquement si elle doit enregistrer les verdicts privés.

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

On this page