MakionDocs ← makion.dev

Méthodologie

L'onglet Méthodologie est l'endroit où un administrateur définit comment l'agent travaille sur un projet — les standards qu'il suit toujours, la méthodologie de chaque rôle et les fichiers de référence qu'il lit à chaque exécution. C'est ainsi que vous faites suivre à Makion la manière exacte de travailler de votre équipe, dans vos propres mots, au lieu des valeurs ABAP par défaut génériques.

Tout ce qui figure dans cet onglet est modifiable uniquement par un administrateur du projet ou un superadmin. Tous les autres voient l'onglet en lecture seule avec la note « Lecture seule — un administrateur modifie ceci. » afin qu'ils puissent voir les standards auxquels l'agent est tenu sans pouvoir les modifier.

La méthodologie est propre à chaque projet. Si deux équipes travaillent sur des systèmes SAP différents avec des standards différents, donnez-leur des projets séparés — voir Configurer des projets — et ajustez la méthodologie de chaque projet indépendamment.

Comment les couches se combinent#

Makion oriente l'agent à partir de trois couches à la fois. À chaque exécution, elles sont combinées en le contexte à partir duquel l'agent travaille :

  1. Règles de base — toujours appliquées, pour chaque tâche du projet.
  2. La méthodologie du rôle choisi — le prompt système du rôle que le développeur a sélectionné dans Chat (par exemple un rôle de construction vs un rôle de revue en lecture seule).
  3. Fichiers de la base de connaissances — standards et exemples matérialisés dans le contexte de l'agent à chaque exécution.

Ainsi, une seule requête est façonnée par les règles de base + le rôle que vous avez choisi + la base de connaissances, ensemble. Les règles de base établissent la vérité de fond pour tout le projet ; le rôle la restreint au type de tâche ; la base de connaissances fournit les patterns et exemples concrets.

Les trois blocs#

Bloc Ce qu'il contient Qui peut le modifier
Règles de base La méthode et les standards que l'agent suit toujours pour ce projet Administrateur du projet / superadmin
Rôles La méthodologie de chaque rôle que le développeur peut choisir dans Chat Administrateur du projet / superadmin
Base de connaissances Fichiers que l'agent lit lorsqu'il travaille Administrateur du projet / superadmin

Règles de base#

Les règles de base sont la méthode et les standards que l'agent suit toujours pour ce projet, quel que soit le rôle choisi. Une ligne de statut vous indique d'où proviennent les règles actuelles :

Contrôle Ce qu'il fait
Zone de texte des règles de base Un grand éditeur contenant le texte complet des règles de base que l'agent applique toujours.
Enregistrer les règles de base Enregistre vos modifications et bascule le statut sur « Personnalisées pour ce projet. »

Rédigez les règles de base en langage courant : conventions de nommage, attentes clean-core, discipline de transport, habitudes de revue — tout ce que l'agent doit respecter à chaque tâche.

Rôles#

Le bloc Rôles définit la méthodologie de chaque rôle que le développeur peut choisir dans Chat. Un rôle est à la fois une frontière de permissions et une manière de travailler : les rôles en lecture seule ne peuvent pas modifier SAP, et cette limite est appliquée dans les outils donnés à l'agent, pas seulement décrite dans le texte. Pour l'image complète de la façon dont les rôles délimitent l'agent, voir Comment fonctionnent les rôles et Rôles de développement.

Les rôles apparaissent sous forme d'onglets — un par rôle. Un rôle personnalisé affiche une étiquette « custom » afin que vous puissiez voir d'un coup d'œil quels rôles vous avez adaptés et lesquels sont encore sur les valeurs par défaut.

Pour le rôle sélectionné, vous pouvez modifier :

Contrôle Ce qu'il fait
Libellé Le nom d'affichage du rôle, tel qu'il apparaît dans le sélecteur de rôle de Chat.
Description Une courte ligne décrivant quand utiliser ce rôle.
Peut modifier SAP (écriture) Indique si ce rôle peut écrire dans SAP. Non coché = lecture seule : l'agent ne reçoit que les outils de lecture et ne peut physiquement pas modifier SAP.
Zone de texte du contenu La méthodologie / le prompt système du rôle — comment l'agent doit aborder ce type de tâche.
Enregistrer le rôle Enregistre le libellé, la description, l'indicateur d'écriture et le contenu de ce rôle.
Réinitialiser par défaut Pour un rôle intégré personnalisé, restaure la valeur par défaut livrée par Makion. Supprime l'étiquette « custom ».

Peut modifier SAP (écriture) décide si l'agent peut modifier votre système dans ce rôle. Laissez-le non coché pour tout ce qui ne doit qu'investiguer ou réviser. Lecture seule signifie lecture seule — les outils d'écriture ne sont jamais transmis à l'agent.

Ajuster les rôles est la partie la plus déterminante de l'onglet Méthodologie : c'est ainsi qu'un administrateur encode « voici exactement comment nous construisons, révisons et supportons l'ABAP » dans chaque conversation. Partez de Configurer des projets lorsque vous mettez en place la méthodologie d'un nouveau projet.

Base de connaissances#

La base de connaissances contient les fichiers que l'agent lit lorsqu'il travaille — vos standards, patterns et exemples concrets. Ces fichiers sont matérialisés dans le contexte de l'agent à chaque exécution, de sorte que tout ce que vous y mettez est un matériau de référence sur lequel l'agent peut s'appuyer directement.

Contrôle Ce qu'il fait
Liste de fichiers Tous les fichiers de connaissances du projet, par chemin.
Ajouter Créer un nouveau fichier. Donnez-lui un chemin comme knowledge/patterns/my-rule.md.
Éditeur Le contenu du fichier sélectionné.
Modifier Ouvrir le fichier sélectionné pour le modifier.
Enregistrer Enregistrer le contenu du fichier en cours.
Supprimer Retirer le fichier sélectionné de la base de connaissances.

Utilisez des dossiers dans le chemin (par exemple knowledge/patterns/… ou knowledge/examples/…) pour garder la base organisée à mesure qu'elle grandit. Bons candidats : un exemple canonique de « comment nous structurons un report », un pattern de gestion des erreurs préféré, un aide-mémoire de nommage, une checklist que l'agent doit parcourir avant de terminer.

Les règles de base conviennent le mieux aux principes courts et toujours vrais. La base de connaissances convient le mieux aux matériaux de référence plus longs et aux exemples concrets que l'agent doit imiter. Ensemble, elles vous permettent de « faire grandir le standard » au fil du temps sans alourdir les règles de base.

Où aller ensuite#