Gestion des connaissances

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.

La gestion des connaissances est expérimentale et doit être activée 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 :

• --name ou -n : Nom descriptif pour l'entrée de connaissance
• --path ou -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

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écursive
• target/** - Tout ce qui se trouve dans le répertoire target
• node_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 /knowledge fonctionnent 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

1. Filtrage par motifs : Les fichiers sont filtrés par motifs d'inclusion/exclusion
2. Découverte de fichiers : Analyse récursive des types de fichiers pris en charge
3. Extraction de contenu : Le texte est extrait de chaque fichier
4. Découpage : Les fichiers volumineux sont divisés en segments recherchables
5. Traitement en arrière-plan : Indexation asynchrone
6. 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 show pour 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

1. Vérifiez les motifs : Assurez-vous que les motifs d'inclusion correspondent à vos fichiers
2. Vérifiez les motifs d'exclusion : Assurez-vous qu'ils ne filtrent pas les fichiers souhaités
3. Vérifiez les types de fichiers : Assurez-vous que les fichiers ont des extensions prises en charge
4. Surveillez la progression : Utilisez /knowledge show pour vérifier le statut de l'indexation
5. Vérifiez les chemins : Assurez-vous que les chemins existent et sont accessibles
6. Vérifiez les erreurs : Recherchez les messages d'erreur dans la sortie de la CLI

1. Attendez la fin de l'indexation : Utilisez /knowledge show pour vous assurer qu'elle est terminée
2. Essayez différentes requêtes : Utilisez diverses formulations et mots-clés
3. Vérifiez le contenu : Confirmez que le contenu a été ajouté avec /knowledge show
4. Vérifiez les types de fichiers : Les types non pris en charge n'auront pas de contenu recherchable

1. Vérifiez les opérations : Utilisez /knowledge show pour la progression
2. Annulez si nécessaire : Utilisez /knowledge cancel pour les opérations problématiques
3. Ajoutez des segments plus petits : Envisagez des sous-répertoires plutôt que des projets entiers
4. Utilisez de meilleurs motifs : Excluez les fichiers inutiles
5. Ajustez les paramètres : Réduisez maxFiles ou chunkSize pour une meilleure performance

1. Testez les motifs : Commencez simplement, puis ajoutez de la complexité
2. Vérifiez la syntaxe : Assurez-vous que les motifs glob utilisent la syntaxe correcte (** pour la récursivité)
3. Vérifiez les chemins : Assurez-vous que les motifs correspondent aux chemins de fichiers réels
4. Utilisez des motifs absolus : Envisagez des chemins complets pour plus de précision

• Gestion du contexte
• Agents personnalisés
• Configuration des paramètres
• Fonctionnalités expérimentales