Passer au contenu principal
Afficher en Markdown

Knowledge

La bibliothèque Knowledge est un dépôt organisé de contenu externe que vous voulez que l'agent utilise comme référence. Contrairement à la Memory (qui se constitue automatiquement à partir des conversations), Knowledge est intentionnelle — vous choisissez ce qui y entre.

Ce que c'est

Ajoutez des fichiers, des dossiers ou des URL à la bibliothèque. Crew les découpe en segments, les indexe et les intègre afin que l'agent puisse rechercher et référencer le contenu pendant les conversations. Utilisez-la pour :

  • La documentation de projet que l'agent devrait connaître
  • Les références API et les Specs
  • Les guides d'exploitation et les procédures normalisées
  • Les dépôts de code que vous voulez que l'agent comprenne
  • Les articles ou pages externes pertinents à votre travail

Utiliser le panneau Knowledge

Ouvrez Knowledge à partir de la barre latérale du tableau de bord. Le panneau vous permet de :

  • Ajouter une source — fichier local, dossier local (récursif) ou URL
  • Voir les éléments — consulter ce qui a été ingéré, son état et le contenu découpé en segments
  • Mettre en pause / reprendre — contrôler l'ingestion active
  • Retirer des sources — supprimer des éléments de la bibliothèque

Ajout d'une source de type dossier

Les sources de dossiers sont toujours ajoutées délibérément. Ajoutez un dossier depuis la bibliothèque, examinez la source proposée et confirmez-la avant que Crew l'analyse. Crew ne crée plus automatiquement de dossiers dans la bibliothèque Knowledge.

Une source de dossier enregistrée automatiquement par une ancienne installation de Crew est placée en attente de confirmation. Elle n'est pas analysée de nouveau tant que vous ne l'avez pas examinée et confirmée.

Lorsque vous confirmez un dossier, Crew l'analyse de façon récursive :

  • Exclusions par défaut pour les fichiers indésirables du système d'exploitation (.DS_Store, *.tmp, *.swp, etc.)
  • ignore_patterns propres à chaque source pour la personnalisation
  • Une étape de confirmation montre ce qui sera ingéré avant que le processus ne débute
  • La progression est visible directement à l'écran pendant le traitement des fichiers

Ajout d'une source de type URL

Crew récupère le contenu de l'URL, le découpe en segments et l'indexe. Utile pour les sites de documentation, les références API ou les articles dont vous voulez que l'agent s'inspire.

Comment la recherche s'effectue

L'agent effectue des recherches dans la bibliothèque Knowledge via local_knowledge_search lorsque votre requête fait explicitement appel à de la documentation stockée ou correspond à une source de Knowledge configurée. La recherche utilise la similarité vectorielle lorsque les intégrations sont disponibles et se replie sur les mots-clés pendant que le modèle est indisponible.

Limitez une recherche à une source ou un espace de noms lorsque plusieurs sources couvrent des termes similaires. Consultez d'abord la liste des sources pour découvrir l'identifiant stable plutôt que de le deviner. La portée restreint les résultats de départ par mots-clés et par vecteur; la traversée de graphe peut encore utiliser les relations entre sources lors de l'assemblage du classement final. Les résultats identifient leur source et les segments de contenu correspondants.

Couverture du code et des documents

Les analyses de dossiers reconnaissent les fichiers sources courants, notamment Python, Java, TypeScript, JavaScript, Rust, Go, Ruby, C, C++, shell et PowerShell. Crew 0.7 ajoute C# (.cs), Kotlin (.kt, .kts), Swift (.swift) et Scala (.scala) à l'ensemble d'ingestion de code.

Markdown, texte brut, Org Mode, HTML, PDF, CSV, JSON/JSONL, YAML et .docx utilisent leurs lecteurs correspondants. Les fichiers que la source exclut, les fichiers dépassant les budgets configurés et les lectures en échec sont signalés plutôt que silencieusement comptabilisés comme réussites.

Statistiques de la bibliothèque

Consultez un instantané des comptages de la bibliothèque sans exécuter de migration ni de réparation :

bash
kirocrew knowledge stats kirocrew knowledge stats --json

La sortie indique le nombre total de sources, de documents et d'éléments, ainsi que les comptages par source. L'outil de liste de sources côté agent utilise la même vue agrégée.

Knowledge et Memory

KnowledgeMemory
Comment le contenu y entreVous l'ajoutez manuellement (fichiers, dossiers, URL)Automatiquement à partir des conversations
Ce qui y est stockéDocuments et références externesPréférences, historique, leçons, faits, épisodes
Action de l'utilisateurRequise (ajouter des sources, confirmer)Aucune (apprentissage autonome)
Idéal pour« L'agent devrait connaître cette documentation »« L'agent devrait se souvenir de mes préférences »
PanneauÉlément dédié Knowledge dans la barre latéraleConsultable via Paramètres → Memory

Les deux contribuent à ce que l'agent sait, mais ils servent des objectifs différents et sont gérés différemment.

Intégrations

Les éléments de Knowledge sont intégrés pour la recherche sémantique à l'aide du même moteur d'intégration en processus que Memory. Le modèle se télécharge automatiquement au premier démarrage (~610 Mo). En attendant qu'il soit prêt, la recherche se replie sur la correspondance par mots-clés.

Aucune configuration requise — les intégrations sont toujours actives.

Quand l'agent utilise Knowledge

L'agent effectue une recherche dans Knowledge lorsque :

  • Vous posez une question sur quelque chose qui correspond à du contenu dans la bibliothèque
  • Un Skill ou un flux de travail déclenché fait référence à du contenu de la bibliothèque
  • L'outil local_knowledge_search se déclenche selon des signaux de pertinence

Elle ne déverse pas toute la bibliothèque dans le contexte — elle récupère les segments les plus pertinents pour la question en cours.

Page mise à jour : 25 septembre 2026