Centre d'aide · Comprendre
Comment expliquer mes conventions internes aux agents ?
Écrire ce qu'un nouvel arrivant aurait besoin qu'on lui explique, pour que chaque run le sache.
Préférences → Mes contextes vous laisse écrire, en texte libre, ce que les agents ne peuvent pas deviner : votre bibliothèque maison, vos conventions de nommage, les pièges de votre code. Ces textes entrent dans chaque run, en plus des règles de la technologie.
Qu'est-ce qui mérite d'y figurer ?
Le test le plus simple : qu'est-ce que j'expliquerais à un développeur compétent qui arrive lundi sur ce projet ? C'est exactement ce dont les agents ont besoin.
Ce qui marche bien :
- « Nos appels API passent tous par
ApiClient, jamais parfetchdirectement. » - « Les libellés utilisateur vivent dans
lang/, jamais en dur dans une vue. » - « Le module
facturesest en cours de réécriture : ne pas y toucher sans le dire. »
Ce qui ne sert à rien : redire les conventions du framework. Diavi les connaît déjà, c'est ce que vous achetez.
Pourquoi un contexte par dépôt ?
Parce que deux dépôts n'ont pas les mêmes conventions, même quand ils utilisent la même technologie. Ce que vous écrivez sur le module d'un client ne doit pas partir dans les runs sur le dépôt d'un autre.
La colonne de gauche liste Tous mes dépôts, pour ce qui ne dépend d'aucun dépôt (vos habitudes de review, votre convention de ticket), puis les dépôts qui ont déjà un contexte. Ajouter un dépôt vous laisse en choisir un dans la liste de votre forge.
Un run charge Tous mes dépôts plus le dépôt sur lequel il travaille, jamais les autres.
Si vous aviez rangé des contextes par technologie, ils apparaissent sous Ancien classement par techno : ils partent toujours dans les runs de cette technologie, mais on n'y crée plus de fichier. Recopiez-les dans un dépôt ou dans Tous mes dépôts, puis supprimez-les.
Y a-t-il une limite de taille ?
Oui, 40 000 caractères pour ce qu'un run charge réellement : Tous mes dépôts plus un dépôt. La jauge affiche ce total pour la portée ouverte. Ce n'est pas arbitraire : ce texte part dans chaque appel du run, donc sa taille se retrouve directement dans votre consommation. L'interface vous refuse l'enregistrement au-delà plutôt que de tronquer en silence.
Qui peut les modifier ?
Le propriétaire du compte et les administrateurs. Un contexte entre dans chaque prompt : c'est un levier de coût, pas un réglage de confort.
Est-ce que je vois les règles de Diavi ?
Non. Les règles de chaque technologie sont le savoir-faire de Diavi et restent privées. Vos contextes s'ajoutent à elles ; ils ne les remplacent jamais, et vous continuez à bénéficier de leurs mises à jour.