Connaissance

Le concept

La connaissance projet, c'est ce que Sonenta sait de votre produit pour bien traduire et garder une qualité cohérente. Elle s'organise en trois niveaux :

• Le contexte de projet (niveau projet) : description du produit, audience, ton, conventions et registre. C'est le cadre que toute traduction respecte.
• Le glossaire (niveau terme) : les termes et leurs traductions imposées, ou les termes à ne pas traduire. Chaque entrée porte un term, des translations par locale, un rule_type (translation, do_not_translate ou forbidden), une option case_sensitive et une note.
• Les indices par chaîne (niveau clé) : le champ description d'une clé porte un indice de traduction pour cette chaîne précise, utile pour les cas ambigus.

L'agent de traduction (sonenta-i18n) consomme cette connaissance ; l'agent sonenta-knowledge la construit et l'entretient.

Gérer la connaissance

Trois voies, complémentaires :

• Le tableau de bord : éditez le glossaire et le contexte de projet à la main.
• Les outils MCP : glossaire (glossary_list, glossary_create, glossary_update, glossary_delete) et contexte (project_context_get, project_context_set). Note : project_context_set remplace tout le document de contexte, donc le bon réflexe est get puis fusion puis set (l'agent s'en charge).
• L'agent sonenta-knowledge : il lit vos chaînes source et la doc du dépôt, puis écrit le glossaire et le contexte via MCP, 0 crédit IA. Il est non destructif : il propose et confirme avant d'écraser. Trois modes : INIT (amorcer de zéro), AUDIT (état et manques, lecture seule), MAINTAIN (nouveaux termes, usages incohérents, dérive du contexte, il propose les mises à jour).

Bonnes pratiques

• Définissez le glossaire tôt : c'est lui qui fige la terminologie.
• Marquez les termes de marque et les termes à ne pas traduire (rule_type do_not_translate ou forbidden).
• Donnez un contexte clair : audience, ton, registre.
• Ajoutez des indices par chaîne (la description de la clé) pour les cas ambigus.
• Tenez la connaissance à jour au fil du produit (mode MAINTAIN).

Demander à l'agent

Quelques prompts adressés à sonenta-knowledge :

Avec sonenta-knowledge, initialise la connaissance du projet à partir de mes chaînes source et de mon README.

Ajoute « Sonenta » au glossaire en do_not_translate, et « tableau de bord » avec la traduction anglaise « dashboard ».

Définis le contexte projet : audience = développeurs, ton = direct, registre = tutoiement professionnel.

Passe en revue mon glossaire et propose les termes de marque manquants.