Qu’est-ce que Knowledge ?
Tout comme l’intégration d’un nouvel ingénieur, l’intégration de Devin nécessite un investissement initial en transfert de connaissances. Knowledge est un ensemble de conseils, d’astuces et d’instructions auxquels Devin peut se référer dans toutes les sessions. Vous pouvez continuellement enrichir la base de Knowledge de Devin au fil du temps, et Devin rappellera automatiquement les éléments de Knowledge pertinents si nécessaire. Utilisez la fonctionnalité Knowledge pour partager de la documentation, des conseils, des bibliothèques internes personnalisées et d’autres ressources dont Devin peut avoir besoin.Comment créer une Knowledge ?
Accédez à Settings → Resources → Knowledge, puis cliquez sur Create knowledge en haut à droite. Votre Trigger Description aidera Devin à retrouver la Knowledge pertinente au bon moment. Il peut s’agir d’une simple expression ou d’une phrase. Devin récupérera un élément de Knowledge lorsque son travail en cours est lié aux déclencheurs spécifiés, et chaque Knowledge doit avoir une Trigger Description. Le Content doit être composé de quelques phrases contenant les informations pertinentes.Macros
Vous pouvez attribuer une macro à n’importe quel élément de Knowledge — un identifiant court commençant par! (par ex., !deploy-checklist). Les macros vous permettent de référencer rapidement des éléments de Knowledge dans vos prompts en saisissant le nom de la macro. Les macros ne peuvent contenir que des lettres, des chiffres et des traits d’union, et doivent être uniques au sein de votre organisation.
Activer et désactiver Knowledge
Chaque élément de Knowledge peut être activé ou désactivé individuellement par utilisateur. Désactiver un élément de Knowledge empêche Devin de le récupérer dans vos sessions, sans le supprimer de l’organisation. Cela est utile lorsqu’un élément de Knowledge est temporairement non pertinent pour votre travail, mais peut être utile à des coéquipiers ou à l’avenir.Suggestions de Knowledge
Devin va automatiquement suggérer des éléments de Knowledge à mémoriser en fonction de vos retours dans le chat. Modifiez la Knowledge suggérée avant de l’enregistrer, ou ignorez-la si elle n’est pas utile. Vous pouvez également demander à Devin de régénérer une suggestion de Knowledge en fonction de vos retours. Cela peut faciliter l’itération sur les Knowledge suggérées plutôt que de les modifier manuellement. Devin peut aussi proposer des mises à jour pour les éléments de Knowledge existants, en plus de suggérer de nouveaux éléments de Knowledge.Que doit contenir Knowledge ?
Nous vous recommandons d’y inclure les éléments de vos prompts ou playbooks que vous avez tendance à répéter régulièrement. Par exemple : les bugs courants et leurs solutions associées, les pratiques de conformité du code, les workflows de déploiement, les workflows de test, la façon d’interagir avec les outils propriétaires, etc.Organiser Knowledge avec des dossiers
Vous pouvez organiser les éléments de Knowledge dans des dossiers pour en faciliter la gestion. Les dossiers prennent en charge :- Hiérarchie imbriquée — Créez des sous-dossiers pour construire une arborescence de Knowledge structurée.
- Activation/désactivation en bloc — Activez ou désactivez un dossier entier. Lorsqu’un dossier est désactivé, tous les éléments de Knowledge qu’il contient sont désactivés pour vos sessions.
- Déplacement d’éléments — Faites glisser des éléments de Knowledge entre les dossiers, ou utilisez l’action de déplacement pour les réorganiser.
- Organisation automatique — Sélectionnez plusieurs éléments de Knowledge et laissez Devin les trier automatiquement dans des dossiers logiques.
Conseils et astuces
- Créez des éléments de Knowledge spécifiques, chacun ciblé sur un seul workflow ou une seule action. Devin lira l’intégralité du contenu de chaque Knowledge, donc gardez-le pertinent et à jour !
- Divisez votre Knowledge en éléments plus petits lorsque c’est possible. Devin est capable d’accéder à plusieurs « éléments » de Knowledge en même temps.
- Prenez l’habitude d’ajouter et de mettre à jour Knowledge. Ces éléments sont partagés dans toute votre organisation et amélioreront continuellement Devin pour votre équipe au fil du temps.
- Devin ne récupère Knowledge que lorsqu’elle est pertinente, pas tout d’un coup ni uniquement au début. Assurez-vous donc que votre déclencheur de récupération soit très pertinent par rapport au contenu.
- Utilisez des dossiers pour regrouper des éléments de Knowledge connexes (par exemple, par projet, équipe ou workflow) afin de pouvoir activer ou désactiver rapidement des ensembles de Knowledge à mesure que vos priorités changent.
Knowledge d’organisation et d’Enterprise
Le Knowledge peut être limité à une seule organisation ou à l’ensemble de votre Enterprise. Ce qu’affiche la page Knowledge dépend de l’organisation dans laquelle vous vous trouvez :- Organisations non primaires — La page Knowledge comporte deux onglets :
- organisation (par défaut) — Les éléments de Knowledge limités à votre organisation actuelle. Ils sont visibles par tous les membres de l’organisation et constituent le périmètre par défaut des nouveaux éléments de Knowledge.
- Suggestions — Des suggestions de Knowledge générées par IA à partir de vos interactions au cours des sessions.
- Organisation primaire — La page Knowledge affiche une vue unique du Knowledge d’Enterprise, sans onglets. Le Knowledge d’Enterprise s’applique à toutes les organisations de votre Enterprise, et c’est ici que les Enterprise Admin le créent et le gèrent.
Les organisations non primaires n’ont pas d’onglet Enterprise. Si votre organisation appartient à une Enterprise, utilisez le lien Looking for enterprise knowledge? de la page Knowledge pour ouvrir le Knowledge d’Enterprise dans l’organisation primaire de votre Enterprise.
Promotion de la Knowledge d’une organisation vers Enterprise
Si un élément de Knowledge au niveau de l’organisation s’avère suffisamment utile pour être partagé dans toute votre entreprise, vous pouvez le promouvoir directement depuis l’éditeur de Knowledge. Ouvrez l’élément, puis cliquez sur Promote to Enterprise dans l’onglet Details. L’élément passe du périmètre de l’organisation au périmètre Enterprise et devient accessible à toutes les organisations de votre Enterprise. La promotion nécessite des autorisations de gestion de la Knowledge Enterprise et n’est disponible que pour les éléments de Knowledge créés par des utilisateurs dans des organisations appartenant à une entreprise.Épingler Knowledge à des dépôts
Vous pouvez choisir si Knowledge s’applique à aucun dépôt, à un dépôt spécifique ou à tous les dépôts :- Épingler à aucun dépôt : Knowledge n’est utilisée que lorsque Devin juge qu’elle est pertinente pour votre contexte actuel.
- Épingler à un dépôt spécifique : Knowledge est toujours utilisée lorsque Devin travaille dans ce dépôt spécifique.
- Épingler à tous les dépôts : Knowledge s’applique automatiquement à chaque dépôt sur lequel Devin travaille, quelle que soit la session.
FAQ sur la migration de Knowledge vers Skills
Les notes de Knowledge sont progressivement abandonnées au profit des Skills, la méthode standard pour fournir à Devin des instructions réutilisables. Devin se charge de migrer vos notes vers des skills à votre place. Rien ne change pour votre équipe le jour de la bascule, et vous n’avez rien à faire.Correspondance entre une note et une skill
Par exemple, cette note :
devient cette skill :
SKILL.md
FAQ
Devin se comporte-t-il différemment ?
Devin se comporte-t-il différemment ?
Non. Les skills migrés sont chargés en fonction de leur description, de la même manière que les notes l’étaient en fonction de leur déclencheur.
Où trouver les skills migrés ?
Où trouver les skills migrés ?
Dans l’application Devin, sous Customize → Plugins → Knowledge, regroupés selon vos dossiers d’origine.
Où les skills sont-ils stockés ?
Où les skills sont-ils stockés ?
Dans Devin, comme vos notes. Contrairement aux skills que vous commitez dans un repository sous forme de fichiers
SKILL.md, les skills migrés sont stockés dans des plugins gérés par Devin, et non dans vos repositories. Rien n’est commité dans vos dépôts, et vous n’avez aucun fichier à ajouter ni à maintenir.Comment modifier un skill migré ?
Comment modifier un skill migré ?
Accédez à Customize → Skills et ouvrez le skill pour le modifier. Les skills d’organisation peuvent être modifiés par les administrateurs de l’organisation et par les membres disposant de l’autorisation Manage Knowledge ; les skills Enterprise, par les Enterprise Admin.
Comment ajouter des instructions à l'avenir ?
Comment ajouter des instructions à l'avenir ?
Rédigez des Skills. Ils fonctionnent partout où Devin s’exécute : dans la webapp, la CLI et Devin Desktop.
Pour les utilisateurs de l’API
Quels endpoints de l'API sont concernés ?
Quels endpoints de l'API sont concernés ?
Les endpoints des notes de Knowledge
/v3/organizations/{org_id}/knowledge/notes[/{note_id}] et /v3/enterprise/knowledge/notes[/{note_id}], ainsi que les endpoints /knowledge/folders correspondants.Par quoi sont-ils remplacés ?
Par quoi sont-ils remplacés ?
Pour les notes, par les endpoints de skills (v3 bêta), sous
/v3beta1/organizations/{org_id}/managed-plugins et /v3beta1/enterprise/managed-plugins :Les endpoints de liste sont paginés avec
first et after, comme les autres endpoints v3.Comment accéder à une note migrée via l'API ?
Comment accéder à une note migrée via l'API ?
Les notes migrées se trouvent dans le bundle
knowledge, sous leur slug. Listez-les toutes avec GET .../managed-plugins/bundles/knowledge/skills, ou récupérez-en une avec GET .../managed-plugins/bundles/knowledge/skills/deploying-to-staging.