La commande /knowledge fournit une fonctionnalité de base de connaissances persistante pour Kiro CLI, vous permettant de stocker, de rechercher et de gérer des informations contextuelles qui persistent entre les sessions de clavardage.
V3 active les connaissances par défaut. Pour les désactiver, définissez chat.enableKnowledge à false :
kiro-cli settings chat.enableKnowledge false
Dans les harnais d'agent V1 et V2, les connaissances sont expérimentales et doivent être activées avant utilisation :
kiro-cli settings chat.enableKnowledge true
Une fois activée, utilisez les commandes /knowledge dans votre session de clavardage :
/knowledge add --name myproject --path /path/to/project /knowledge show
Affiche toutes les entrées de votre base de connaissances avec des informations détaillées, y compris les dates de création, le nombre d'éléments et le statut de persistance. Affiche également toutes les opérations d'indexation en arrière-plan actives, avec la progression et le temps estimé.
Cette commande unifiée offre une vue complète à la fois de vos connaissances stockées et des opérations en cours.
/knowledge show
Ajoute des fichiers ou des répertoires à votre base de connaissances. Le système indexe récursivement tous les fichiers pris en charge dans les répertoires.
Syntaxe :
/knowledge add --name <name> --path <path> [--include pattern] [--exclude pattern] [--index-type Fast|Best]
Paramètres requis :
--nameou-n: Nom descriptif pour l'entrée de connaissance--pathou-p: Chemin vers le fichier ou le répertoire à indexer
Exemples :
/knowledge add --name "project-docs" --path /path/to/documentation /knowledge add -n "config-files" -p /path/to/config.json /knowledge add --name "fast-search" --path /path/to/logs --index-type Fast /knowledge add -n "semantic-search" -p /path/to/docs --index-type Best
Choisissez l'approche d'indexation qui correspond le mieux à vos besoins :
Avantages :
- ✅ Indexation ultrarapide - traite les fichiers rapidement
- ✅ Recherche instantanée - basée sur des mots-clés avec des résultats immédiats
- ✅ Faible utilisation des ressources - CPU et mémoire minimaux
- ✅ Parfait pour les journaux, les fichiers de configuration et les grandes bases de code
Désavantages :
- ❌ Moins intelligent - nécessite des correspondances exactes de mots-clés
Avantages :
- ✅ Recherche intelligente - comprend le contexte et le sens
- ✅ Requêtes en langage naturel - recherchez avec des phrases complètes
- ✅ Trouve des concepts connexes - même sans mots-clés exacts
- ✅ Parfait pour la documentation et la recherche
Désavantages :
- ❌ Indexation plus lente - nécessite un traitement par modèle d'IA
- ❌ Utilisation des ressources plus élevée - plus exigeant en CPU et en mémoire
| Cas d'utilisation | Type recommandé | Pourquoi |
|---|---|---|
| Fichiers journaux, messages d'erreur | Fast | Recherches par mots-clés rapides, grands volumes |
| Fichiers de configuration | Fast | Recherches exactes de paramètres/valeurs |
| Grandes bases de code | Fast | Recherches rapides de symboles et de fonctions |
| Documentation | Best | Compréhension du langage naturel |
| Articles de recherche | Best | Recherche basée sur les concepts |
| Contenu mixte | Best | Meilleure expérience de recherche globale |
Si vous ne spécifiez pas --index-type, le système utilise votre valeur par défaut configurée :
# Set your preferred default kiro-cli settings knowledge.indexType Fast # or Best # This will use your default setting /knowledge add "my-project" /path/to/project
Contrôlez les fichiers indexés à l'aide de motifs d'inclusion et d'exclusion :
/knowledge add "rust-code" /path/to/project --include "*.rs" --exclude "target/**" /knowledge add "docs" /path/to/project --include "**/*.md" --include "**/*.txt" --exclude "node_modules/**"
Exemples de motifs :
*.rs- Tous les fichiers Rust de manière récursive (équivalent à**/*.rs)**/*.py- Tous les fichiers Python de manière récursivetarget/**- Tout ce qui se trouve dans le répertoire targetnode_modules/**- Tout ce qui se trouve dans node_modules
Comportement des motifs par défaut :
Lorsque vous ne spécifiez pas de motifs, le système utilise les valeurs par défaut configurées :
kiro-cli settings knowledge.defaultIncludePatterns '["**/*.rs", "**/*.py"]' kiro-cli settings knowledge.defaultExcludePatterns '["target/**", "__pycache__/**"]' # Uses default patterns /knowledge add "my-project" /path/to/project # Overrides defaults /knowledge add "docs-only" /path/to/project --include "**/*.md"
Fichiers texte : .txt, .log, .rtf, .tex, .rst
Markdown : .md, .markdown, .mdx
JSON : .json (traité comme du texte pour la recherche)
Configuration : .ini, .conf, .cfg, .properties, .env
Fichiers de données : .csv, .tsv
Formats Web : .svg (basé sur du texte)
Fichiers de code : .rs, .py, .js, .jsx, .ts, .tsx, .java, .c, .cpp, .h, .hpp, .go, .rb, .php, .swift, .kt, .kts, .cs, .sh, .bash, .zsh, .html, .htm, .xml, .css, .scss, .sass, .less, .sql, .yaml, .yml, .toml
Fichiers spéciaux : Dockerfile, Makefile, LICENSE, CHANGELOG, README (fichiers sans extensions)
Remarque : Les fichiers non pris en charge sont indexés sans extraction du contenu textuel.
Supprime des entrées de votre base de connaissances par nom, chemin ou identifiant de contexte.
/knowledge remove "project-docs" # Remove by name /knowledge remove /path/to/old/project # Remove by path
Met à jour (réindexe) une entrée existante de la base de connaissances avec du nouveau contenu. Les motifs d'inclusion/exclusion d'origine sont conservés.
# Re-index a single entry /knowledge update /path/to/updated/project # Re-index every entry at once /knowledge update
Exécutez /knowledge update sans arguments pour réindexer toutes les entrées de votre base de connaissances en une seule fois, plutôt que de mettre à jour un chemin à la fois.
Supprime toutes les entrées de votre base de connaissances. Une confirmation est requise et l'action est irréversible.
/knowledge clear
Une invite vous sera présentée :
⚠️ This will remove ALL knowledge base entries. Are you sure? (y/N):
Annule les opérations en arrière-plan. Annule une opération spécifique par identifiant ou toutes les opérations.
/knowledge cancel abc12345 # Cancel specific operation /knowledge cancel all # Cancel all operations
Configurez le comportement de la base de connaissances :
# Maximum files per knowledge base kiro-cli settings knowledge.maxFiles 10000 # Text chunk size for processing kiro-cli settings knowledge.chunkSize 1024 # Overlap between chunks kiro-cli settings knowledge.chunkOverlap 256 # Default index type kiro-cli settings knowledge.indexType Fast # Default include patterns kiro-cli settings knowledge.defaultIncludePatterns '["**/*.rs", "**/*.md"]' # Default exclude patterns kiro-cli settings knowledge.defaultExcludePatterns '["target/**", "node_modules/**"]'
Chaque agent maintient sa propre base de connaissances isolée, garantissant que les contextes de connaissances sont limités à l'agent spécifique avec lequel vous travaillez. Cela offre une meilleure organisation et évite les conflits de connaissances.
Les bases de connaissances sont stockées dans le répertoire de données local de votre système :
- macOS :
~/Library/Application Support/kiro-cli/knowledge_bases/ - Linux :
~/.local/share/kiro-cli/knowledge_bases/ - Windows :
%LOCALAPPDATA%\kiro-cli\knowledge_bases\
knowledge_bases/ ├── kiro_cli_default/ # Default agent │ ├── contexts.json │ ├── context-id-1/ │ │ ├── data.json │ │ └── bm25_data.json │ └── context-id-2/ │ └── data.json ├── my-custom-agent_<code>/ # Custom agent │ ├── contexts.json │ └── context-id-3/ │ └── data.json └── another-agent_<code>/ # Another agent ├── contexts.json └── context-id-4/ └── data.json
- Portée automatique : Les commandes
/knowledgefonctionnent sur la base de connaissances de l'agent actuel - Aucun accès entre agents : L'agent A ne peut pas accéder aux connaissances de l'agent B
- Configuration indépendante : Chaque agent a des paramètres et des contextes différents
- Prise en charge de la migration : Les bases de connaissances héritées migrent vers l'agent par défaut
Lorsque vous changez d'agent, les commandes de connaissances fonctionnent automatiquement avec la base de connaissances de cet agent.
# Working with default agent /knowledge add /path/to/docs # Switch to custom agent kiro chat --agent my-custom-agent # Creates separate knowledge base for my-custom-agent /knowledge add /path/to/agent/docs # Switch back to default kiro chat # Only sees original docs, not agent-specific docs /knowledge show
- Filtrage par motifs : Les fichiers sont filtrés par motifs d'inclusion/exclusion
- Découverte de fichiers : Analyse récursive des types de fichiers pris en charge
- Extraction de contenu : Le texte est extrait de chaque fichier
- Découpage : Les fichiers volumineux sont divisés en segments recherchables
- Traitement en arrière-plan : Indexation asynchrone
- Plongement sémantique : Le contenu est traité pour la recherche sémantique
Les bases de connaissances utilisent la recherche sémantique :
- Requêtes en langage naturel
- Résultats classés par pertinence, pas seulement par mots-clés
- Concepts connexes trouvés même sans correspondance exacte de mots
- Les contextes survivent entre les sessions de clavardage et les redémarrages de la CLI
- La persistance est déterminée automatiquement selon les habitudes d'utilisation
- Les motifs d'inclusion/exclusion sont stockés et réutilisés lors des mises à jour
- Utilisez des noms descriptifs : « api-documentation » et non « docs »
- Regroupez les fichiers connexes dans des répertoires avant de les ajouter
- Utilisez des motifs d'inclusion/exclusion pour vous concentrer sur les fichiers pertinents
- Révisez et mettez à jour régulièrement les contextes obsolètes
- Utilisez le langage naturel : « comment gérer les erreurs d'authentification à l'aide de l'outil de connaissances »
- Soyez précis : « configuration de la connexion à la base de données »
- Essayez différentes formulations si les recherches initiales ne fonctionnent pas
- Invitez Kiro à utiliser l'outil : « trouve la configuration de la connexion à la base de données à l'aide de tes bases de connaissances »
- Ajoutez des répertoires de projet plutôt que des fichiers individuels
- Utilisez des motifs pour éviter les artéfacts de compilation :
--exclude "target/**" --exclude "node_modules/**" - Utilisez
/knowledge showpour surveiller la progression de l'indexation - Envisagez de diviser les grands projets en sous-répertoires logiques
- Soyez précis : Utilisez des motifs précis pour éviter une inclusion excessive
- Excluez les artéfacts de compilation : Excluez toujours
target/**,node_modules/**,.git/** - Incluez les extensions pertinentes : Concentrez-vous sur les types de fichiers dont vous avez besoin
- Testez les motifs : Vérifiez que les motifs correspondent aux fichiers attendus avant les opérations de grande envergure
- Les fichiers binaires sont ignorés lors de l'indexation
- Les fichiers très volumineux peuvent être découpés, ce qui peut fragmenter le contenu connexe
- Certains formats spécialisés peuvent ne pas extraire le contenu de manière optimale
- L'indexation de grands répertoires peut prendre beaucoup de temps
- Les opérations en arrière-plan sont limitées par le traitement simultané
- La performance de recherche varie selon la taille de la base de connaissances
- Le filtrage par motifs améliore la performance pour les grands répertoires
- Aucune limite explicite de taille de stockage, mais des limites pratiques s'appliquent
- Aucun nettoyage automatique des contextes anciens ou inutilisés
- Les opérations d'effacement sont irréversibles et il n'y a aucune sauvegarde
- Vérifiez les motifs : Assurez-vous que les motifs d'inclusion correspondent à vos fichiers
- Vérifiez les motifs d'exclusion : Assurez-vous qu'ils ne filtrent pas les fichiers souhaités
- Vérifiez les types de fichiers : Assurez-vous que les fichiers ont des extensions prises en charge
- Surveillez la progression : Utilisez
/knowledge showpour vérifier le statut de l'indexation - Vérifiez les chemins : Assurez-vous que les chemins existent et sont accessibles
- Vérifiez les erreurs : Recherchez les messages d'erreur dans la sortie de la CLI
- Attendez la fin de l'indexation : Utilisez
/knowledge showpour vous assurer qu'elle est terminée - Essayez différentes requêtes : Utilisez diverses formulations et mots-clés
- Vérifiez le contenu : Confirmez que le contenu a été ajouté avec
/knowledge show - Vérifiez les types de fichiers : Les types non pris en charge n'auront pas de contenu recherchable
- Vérifiez les opérations : Utilisez
/knowledge showpour la progression - Annulez si nécessaire : Utilisez
/knowledge cancelpour les opérations problématiques - Ajoutez des segments plus petits : Envisagez des sous-répertoires plutôt que des projets entiers
- Utilisez de meilleurs motifs : Excluez les fichiers inutiles
- Ajustez les paramètres : Réduisez
maxFilesouchunkSizepour une meilleure performance
- Testez les motifs : Commencez simplement, puis ajoutez de la complexité
- Vérifiez la syntaxe : Assurez-vous que les motifs glob utilisent la syntaxe correcte (
**pour la récursivité) - Vérifiez les chemins : Assurez-vous que les motifs correspondent aux chemins de fichiers réels
- Utilisez des motifs absolus : Envisagez des chemins complets pour plus de précision
Gestion des connaissances