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 et .windsurf. Notez que Devin n’extraira pas automatiquement des types de fichiers plus génériques comme .md.

​
Bonnes pratiques pour l’onboarding Knowledge

Il est utile de consacrer un peu de temps au départ pour mettre Devin à niveau. Comme pour une nouvelle recrue, 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 à suivre lors de la première configuration de Knowledge pour Devin :
  1. Passez en revue toute Knowledge générée automatiquement et vérifiez (a) son exhaustivité et (b) son exactitude.
  2. Si vous voulez que Devin consulte la note Knowledge à chaque fois qu’il travaille sur une session, assurez-vous de l’épingler à tous les dépôts. Sinon, vous pouvez l’épingler à un dépôt spécifique si l’information n’est pertinente que dans ce contexte. Si Knowledge n’est pas épinglée, elle ne sera utilisée que lorsqu’un déclencheur l’active ; veillez donc à ce que votre Trigger Description soit claire.
  3. Si vous n’avez pas de fichier de documentation centralisé et spécialisé dans votre base de code, nous vous recommandons fortement d’en créer un avec une extension de fichier dédiée.
Consultez le guide produit Knowledge pour plus de détails.