L'agent de Kiro comprend des outils intégrés pour les tâches de développement. Ceux-ci sont fournis par le harnais d'agent unifié et partagés entre les surfaces. L'agent par défaut a accès à tous les outils intégrés - les agents personnalisés peuvent restreindre cela.
En un coup d'œil :
| Multi-surfaces | Lecture/écriture de fichiers, shell, recherche/récupération Web, sous-agents, contexte, suivi des tâches, introspection |
| IDE et CLI | Création de Hooks |
| IDE et Web | Powers (kiro_powers) |
| IDE seulement | Processus en arrière-plan (serveurs de développement), analyse du code de l'éditeur (read_code, renommage sémantique) |
| CLI seulement | Intelligence du code (code), objectif, paramètres de session, recherche d'outils MCP (tool_search), knowledge (expérimental), thinking (expérimental) |
| Obsolète | aws, delegate - en cours de remplacement |
| Configuration | Utilisez le champ tools des agents personnalisés + les permissions |
Tous les outils ci-dessous sont disponibles sur IDE, CLI, Web et Mobile.
| Outil | Catégorie | Description |
|---|---|---|
read_file / read_files | Fichier | Lire un ou plusieurs fichiers |
list_directory | Fichier | Lister le contenu d'un répertoire |
file_search | Fichier | Recherche floue de chemins de fichiers (glob) |
grep_search | Fichier | Recherche de contenu par expression régulière |
fs_write | Fichier | Créer ou remplacer un fichier |
fs_append | Fichier | Ajouter du contenu à un fichier existant |
str_replace | Fichier | Remplacement de texte ciblé |
delete_file | Fichier | Supprimer un fichier |
execute_bash | Shell | Exécuter une commande shell |
web_search | Web | Effectuer une recherche sur le Web |
web_fetch | Web | Récupérer du contenu à partir d'une URL |
invoke_subagent | Agent | Déléguer des tâches en parallèle |
disclose_context | Contexte | Activer des skills ou du steering |
introspect | Contexte | Répondre aux questions sur les propres fonctionnalités de Kiro à partir de la documentation officielle |
todo_list | Session | Suivre les tâches au sein d'une session |
Certains outils ne sont pas encore disponibles sur toutes les surfaces :
| Outil | IDE | CLI | Web | Mobile | État |
|---|---|---|---|---|---|
control_bash_process | ✓ | — | — | — | GA |
get_process_output | ✓ | — | — | — | GA |
list_processes | ✓ | — | — | — | GA |
kiro_powers | ✓ | — | ✓ | — | GA |
create_hook | ✓ | ✓ | — | — | GA |
code | — | ✓ | — | — | GA |
goal | — | ✓ | — | — | GA |
session_settings | — | ✓ | — | — | GA |
tool_search | — | ✓ | — | — | GA |
knowledge | — | ✓ | — | — | Expérimental |
thinking | — | ✓ | — | — | Expérimental |
aws | — | ✓ | — | — | Obsolète |
delegate | — | ✓ | — | — | Obsolète → utiliser les sous-agents |
Les outils de processus en arrière-plan (control_bash_process, get_process_output, list_processes) alimentent le flux de travail des serveurs de développement de l'IDE. L'outil code (intelligence du code basée sur tree-sitter et LSP - voir le guide) est fourni aux clients autres que l'IDE; dans l'IDE, des capacités équivalentes sont intégrées comme outils natifs de l'éditeur - read_code pour l'analyse AST et le renommage sémantique - s'appuyant sur les serveurs de langage que l'éditeur exécute déjà.
Utilisez le champ tools d'un agent personnalisé pour contrôler quelles catégories d'outils sont disponibles :
{ "tools": ["read", "write", "shell", "web"] }
Chaque catégorie correspond à un ensemble d'outils :
| Catégorie | Comprend |
|---|---|
read | read_file, read_files, list_directory, file_search, grep_search, code |
write | fs_write, fs_append, str_replace, delete_file |
shell | execute_bash, control_bash_process, get_process_output, list_processes |
web | web_fetch, web_search |
subagent | invoke_subagent |
spec | Outils du flux de travail Spec |
context | disclose_context, introspect, knowledge |
Valeurs spéciales :
| Valeur | Effet |
|---|---|
@builtin | Tous les outils intégrés |
@mcp | Tous les outils de serveur MCP |
* | Tout (intégrés + MCP) |
Exclure des catégories spécifiques : "excludedTools": ["web"]
Contrôlez ce que les outils peuvent faire (pas seulement lesquels sont visibles) avec les permissions.
| Outil | Description |
|---|---|
read_file | Lire un seul fichier (texte ou image). Alias : fs_read |
read_files | Lire plusieurs fichiers avec des plages de lignes facultatives |
list_directory | Lister le contenu d'un répertoire en format détaillé |
file_search | Recherche floue de chemins de fichiers (motifs glob). Alias : glob |
grep_search | Recherche de contenu par expression régulière dans les fichiers. Alias : grep |
code | Analyse de code basée sur l'AST - signatures, symboles, recherche floue |
Tous les outils de lecture respectent les motifs .kiroignore et les règles de capacité fs_read des permissions.
| Outil | Description |
|---|---|
fs_write | Créer ou remplacer un fichier. Alias : write |
fs_append | Ajouter du contenu à la fin d'un fichier existant |
str_replace | Remplacer un texte exact dans un fichier (modifications ciblées) |
delete_file | Supprimer un fichier |
Les outils d'écriture respectent les règles de capacité fs_write des permissions.
| Outil | Description | Surfaces |
|---|---|---|
execute_bash | Exécuter une commande shell. Alias : shell, execute_cmd | IDE · CLI · Web |
control_bash_process | Démarrer/arrêter des processus en arrière-plan de longue durée | IDE · CLI |
get_process_output | Lire la sortie d'un processus en arrière-plan | IDE · CLI |
list_processes | Lister les processus en arrière-plan en cours d'exécution | IDE · CLI |
Les outils shell respectent les règles de capacité shell des permissions. Utilisez des motifs match pour préapprouver les commandes courantes :
rules: - capability: shell match: ["git *", "npm *", "cargo *"] effect: allow - capability: shell match: ["rm -rf *", "sudo *"] effect: deny
| Outil | Description |
|---|---|
web_search | Rechercher sur le Web des informations actuelles |
web_fetch | Récupérer et extraire le contenu textuel d'une URL |
Limitations : 10 Mo maximum par récupération, délai d'expiration de 30 s, texte/HTML seulement, 3 tentatives.
Les administrateurs d'entreprise peuvent désactiver les outils Web à partir de Settings > Shared settings. Voir Gouvernance d'entreprise - Outils Web.
Compréhension du code basée sur tree-sitter pour 18 langages - recherche de symboles, symboles de document, recherche par motif et réécriture basée sur l'AST. Intégration LSP facultative pour la recherche de références, l'accès à la définition, le renommage et les diagnostics.
Langages pris en charge : Bash, C, C++, C#, Elixir, Go, Java, JavaScript, Kotlin, Lua, PHP, Python, Ruby, Rust, Scala, Swift, TSX, TypeScript
| Outil | Description |
|---|---|
invoke_subagent | Déléguer une tâche à un agent s'exécutant dans un contexte isolé |
Voir Invocation en tant que sous-agents pour le guide complet.
| Outil | Description |
|---|---|
disclose_context | Activer des skills ou des fichiers de steering dans le contexte |
introspect | Rechercher dans la documentation indexée de Kiro (sémantique + BM25) |
knowledge | Rechercher dans des bases de connaissances indexées (expérimental) |
Charge les outils MCP à la demande plutôt que d'inclure chaque définition d'outil dans chaque requête. Maintient le contexte efficace avec de nombreux serveurs MCP. Disponible dans la CLI.
Fonctionnement : Index → liste compacte différée → appel tool_search à la demande → activation de l'outil correspondant.
| Paramètre | Type | Description |
|---|---|---|
tool_id | chaîne | Identifiant exact server_name::tool_name |
query | chaîne | Mots-clés pour la recherche BM25 |
max_results | entier | Nombre maximal de résultats (par défaut : 5) |
Activer dans la CLI : kiro-cli settings toolSearch.enabled true
| Paramètre | Par défaut | Description |
|---|---|---|
toolSearch.enabled | false | Interrupteur principal |
toolSearch.minPct | 5 | S'active lorsque les spécifications d'outils dépassent ce % du contexte |
toolSearch.minTokens | 50000 | S'active lorsque les spécifications d'outils dépassent ce nombre de jetons |
| Outil | Description | État |
|---|---|---|
todo_list | Suivre les tâches au sein d'une session (créer, terminer, lister) | GA |
create_hook | Créer des Agent Hooks depuis le clavardage | GA |
kiro_powers | Lister, activer et utiliser les powers installés | GA |
Outils intégrés