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.

Pipeline → 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 par fetch directement. »
• « Les libellés utilisateur vivent dans lang/, jamais en dur dans une vue. »
• « Le module factures est 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 y a-t-il plusieurs onglets ?

Parce qu'un contexte React n'a rien à faire dans un run Python. Chaque technologie a le sien, et un onglet commun reçoit ce qui ne dépend pas de la technologie — vos habitudes de review, votre convention de ticket.

Le run charge le commun plus celui de sa technologie, jamais les autres.

Y a-t-il une limite de taille ?

Oui, 40 000 caractères pour ce qu'un run charge réellement — le commun plus une technologie. 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 l'éditeur ?

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.