Outils intégrés

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 :

Le catalogue ci-dessous couvre les outils intégrés sur les différentes surfaces Kiro. Leur disponibilité peut varier selon la surface et le moteur d'agent.

Certains outils ne sont pas encore disponibles sur toutes les surfaces ni dans tous les moteurs d'agent. La CLI V3 n'a pas d'outil de liste de tâches; le paramètre chat.enableTodoList n'y a donc aucun effet :

Les outils de processus en arrière-plan (control_bash_process ou control_pwsh_process, get_process_output et list_processes) sont disponibles dans l'IDE, où ils prennent en charge les serveurs de développement. La CLI V3 peut démarrer une commande en arrière-plan au moyen d'execute_bash (execute_pwsh sous Windows) avec run_in_background, mais elle n'enregistre pas ces outils de contrôle des processus. L'outil code (intelligence du code basée sur tree-sitter et LSP) 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 étiquettes de catégorie et quels sélecteurs d'outils directs sont disponibles :

{
  "tools": ["read", "write", "shell", "web"]
}

Correspondances de catégories courantes :

Certains outils intégrés n'ont pas d'étiquette de catégorie, notamment knowledge et invoke_sub_agent. Sélectionnez-les par ID d'outil, ou avec @builtin ou *. invoke_sub_agent peut démarrer n'importe quel agent; un agent dont les tools contiennent @builtin ou * peut donc démarrer n'importe quel sous-agent.

Valeurs spéciales :

Exclure des catégories spécifiques : "excludedTools": ["web"]

Contrôlez ce que les outils peuvent faire (pas seulement lesquels sont visibles) avec les permissions.

Tous les outils de lecture appliquent les règles de capacité fs_read des permissions. La prise en charge de .kiroignore varie selon la surface; dans la CLI V3, les lectures directes correspondantes sont bloquées, tandis que file_search et grep_search filtrent les chemins ignorés de leurs résultats.

Les outils d'écriture respectent les règles de capacité fs_write des permissions.

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

Guide détaillé →

Limitations : 10 Mo maximum par récupération, délai d'expiration de 30 s, texte/HTML seulement. Le comportement de nouvelle tentative varie selon la surface; la CLI V3 réessaie une fois en cas de défaillance passagère.

Les administrateurs d'entreprise peuvent désactiver les outils Web à partir de Settings > Shared settings. Voir Gouvernance d'entreprise - Outils Web.

Guide détaillé →

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

Voir Invocation en tant que sous-agents pour le guide complet.

Guide détaillé →

Kiro IDE 1.3 et les versions ultérieures chargent les outils MCP à la demande. C'est aussi le cas des sessions V3 locales dans Kiro CLI 2.31 et les versions ultérieures. Kiro reçoit une liste d'outils compacte, charge les définitions dont il a besoin, puis appelle ces outils en passant par les vérifications habituelles des permissions et des Hooks.

L'activité V3 peut afficher tool_load avant tool_call. Les sessions V2 peuvent activer l'ancien chemin tool_search. Consultez le guide Tool Search.

• Outils Web - guide détaillé
• Intelligence du code - guide détaillé
• Agents personnalisés - configurer les outils auxquels les agents peuvent accéder
• Permissions - contrôler ce que les outils peuvent faire
• MCP - étendre avec des outils externes
• Portées de configuration - où les paramètres des outils sont stockés