Passer au contenu principal

Knowledge 101

Knowledge est le meilleur moyen de partager du contexte au niveau de la base de code (par opposition au niveau de la tâche) pouvant aider Devin lorsqu’il travaille dans votre codebase. Voici quelques exemples d’informations à mettre dans le Knowledge de Devin : pratiques de conformité du code, workflows de déploiement, conventions de nommage des PR, workflows de test, manière d’interagir avec des outils propriétaires, etc. Quelques points à savoir sur Knowledge :
  • Devin générera automatiquement du Knowledge de dépôt à partir des READMEs existants, de la structure des fichiers et du contenu des dépôts connectés. Notez que si vous ne donnez pas à Devin l’accès au dépôt, il ne générera aucun Knowledge associé.
  • Knowledge est récupéré en fonction du Trigger que vous définissez. Plus le Trigger est spécifique (par exemple, pour quel fichier, dépôt ou type de tâche le Knowledge s’applique), plus la récupération sera pertinente. Vous pouvez trouver plus de détails ici.
  • Devin vous indiquera, dans une session, quel Knowledge il a utilisé ; vous pouvez le voir sous « Accessed Knowledge » dans le chat de la session.
  • Devin extraira et mettra automatiquement à jour le Knowledge à partir de fichiers spécialisés dans votre base de code, y compris .rules, .mdc, .cursorrules, .windsurf, CLAUDE.md et AGENTS.md. Notez que Devin n’extraira pas automatiquement des types de fichiers plus génériques comme .md.

Bonnes pratiques pour la prise en main de Knowledge

Il est utile de consacrer un peu de temps dès le départ pour permettre à Devin de monter en compétences. Comme pour une nouvelle recrue, le fait de partager le contexte pertinent sur la base de code et les workflows suivis par l’équipe d’ingénierie contribuera fortement à rendre Devin plus efficace. Voici quelques étapes recommandées lorsque vous configurez Knowledge pour Devin pour la première fois :
  1. Passez en revue tout Knowledge généré automatiquement et vérifiez (a) son exhaustivité et (b) son exactitude.
  2. Si vous souhaitez que Devin référence la note Knowledge chaque fois qu’il travaille sur une session, veillez à l’épingler à tous les dépôts. Sinon, vous pouvez l’épingler uniquement au dépôt concerné si les informations ne sont pertinentes que dans ce contexte. Si Knowledge n’est pas épinglé, il ne sera utilisé que lorsqu’il est déclenché, donc assurez-vous que votre Trigger Description est claire.
  3. Si vous n’avez pas de fichier de documentation centralisé dédié dans votre base de code, nous vous recommandons vivement d’en créer un, avec une extension de fichier spécifique.
Consultez le guide produit Knowledge pour plus de détails.