Tool Search charge les outils MCP à la demande plutôt que d'envoyer la définition de chaque outil avec chaque requête. Cela garde votre fenêtre contextuelle dégagée lorsque vous avez plusieurs serveurs MCP configurés, et permet à l'agent de découvrir automatiquement les bons outils.
| Capacité | IDE | CLI | Web | Mobile |
|---|---|---|---|---|
| Tool Search | — | ✓ | — | — |
Activez Tool Search si :
/tools montre que les outils MCP consomment au total plus de 50 000 jetonsSi vous utilisez seulement quelques outils MCP, la surcharge liée à Tool Search pourrait ne pas en valoir la peine.
Tool Search est désactivé par défaut. Activez-le via les paramètres :
kiro-cli settings toolSearch.enabled true
Une fois activé, Tool Search s'active automatiquement lorsque les spécifications des outils MCP sont suffisamment volumineuses pour bénéficier du report. Les seuils par défaut (5 % de la fenêtre contextuelle ou 50 000 jetons) couvrent la plupart des cas. Pour forcer l'activation dès que des outils MCP sont présents, réglez les seuils à 0 :
kiro-cli settings toolSearch.minPct 0 kiro-cli settings toolSearch.minTokens 0
Configurez le comportement de Tool Search avec ces paramètres :
| Paramètre | Valeur par défaut | Description |
|---|---|---|
toolSearch.enabled | false | Bascule principale pour Tool Search |
toolSearch.minPct | 5 | Active lorsque les spécifications des outils MCP dépassent ce % de la fenêtre contextuelle |
toolSearch.minTokens | 50000 | Active lorsque les spécifications des outils MCP dépassent ce nombre de jetons |
Lorsque les deux seuils sont définis, Tool Search s'active si l'un ou l'autre est dépassé (logique OU). Lorsque les deux seuils sont réglés à 0, Tool Search est toujours actif, quel que soit le nombre d'outils MCP.
Lorsque Tool Search est actif :
/tools affiche des comptes de jetons réduits pour les outils MCP par rapport à lorsqu'il est désactivétool_search dans l'utilisation des outils de l'agent lorsqu'il découvre des outils à la demandeIndexation : Lorsque les serveurs MCP se connectent, toutes les spécifications d'outils sont indexées pour la recherche par mots-clés. Le nom de chaque outil, le nom du serveur, la description et les descriptions des paramètres sont tokenisés.
Liste d'outils différée : Au lieu de schémas JSON complets, le modèle reçoit une liste compacte d'entrées server_name::tool_name: description. Les descriptions sont tronquées à 1 Ko.
Chargement à la demande : Lorsque le modèle a besoin d'un outil, il appelle tool_search avec soit un tool_id exact (p. ex. builder-mcp::InternalSearch), soit une query par mots-clés (p. ex. "search documents").
Activation : Les outils correspondants sont chargés et leurs schémas complets sont inclus dans les requêtes subséquentes.
Nom de l'outil : tool_search
Trouve et charge les outils MCP à la demande. Autorisé automatiquement sans demande de permission de l'utilisateur (lecture seule).
L'outil tool_search accepte les paramètres suivants :
| Paramètre | Type | Requis | Description |
|---|---|---|---|
tool_id | string | Un de tool_id ou query | Identifiant exact de l'outil au format server_name::tool_name |
query | string | Un de tool_id ou query | Mots-clés pour rechercher des outils correspondants |
max_results | integer | Non | Nombre maximal de résultats à retourner (par défaut : 5) |
Fournissez exactement un des deux paramètres tool_id ou query, pas les deux. Les outils correspondants sont immédiatement activés et disponibles pour l'invocation.
La recherche par mots-clés utilise le calcul de pertinence BM25. Les noms d'outils sont divisés selon les limites de casse (p. ex. ReadFile → read file, read_file → read file) pour améliorer la correspondance. Seuls les résultats au-dessus du seuil de correspondance sont retournés.
Le seuil par défaut est 1.5, configurable via la variable d'environnement KIRO_CLI_TOOL_SEARCH_MATCHING_THRESHOLD.
tool_searchtoolSearch.*
Recherche d'outils