Passer au contenu principal
Afficher en Markdown

Recherche d'outils

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éIDECLIWebMobile
Tool Search—✓——

Activez Tool Search si :

  • Vous avez 5 serveurs MCP configurés ou plus
  • Vous voyez des erreurs de dépassement de la fenêtre contextuelle lors de longues conversations
  • La commande /tools montre que les outils MCP consomment au total plus de 50 000 jetons

Si 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 :

bash
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 :

bash
kiro-cli settings toolSearch.minPct 0 kiro-cli settings toolSearch.minTokens 0

Paramètres

Configurez le comportement de Tool Search avec ces paramètres :

ParamètreValeur par défautDescription
toolSearch.enabledfalseBascule principale pour Tool Search
toolSearch.minPct5Active lorsque les spécifications des outils MCP dépassent ce % de la fenêtre contextuelle
toolSearch.minTokens50000Active 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.

Vérifier que Tool Search est actif

Lorsque Tool Search est actif :

  • La commande /tools affiche des comptes de jetons réduits pour les outils MCP par rapport à lorsqu'il est désactivé
  • Vous verrez des appels tool_search dans l'utilisation des outils de l'agent lorsqu'il découvre des outils à la demande

Fonctionnement

  1. Indexation : 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.

  2. 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.

  3. 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").

  4. 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).

Paramètres

L'outil tool_search accepte les paramètres suivants :

ParamètreTypeRequisDescription
tool_idstringUn de tool_id ou queryIdentifiant exact de l'outil au format server_name::tool_name
querystringUn de tool_id ou queryMots-clés pour rechercher des outils correspondants
max_resultsintegerNonNombre 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.

Correspondance par mots-clés

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.

Prochaines étapes

Page mise à jour : 11 août 2026