search_items

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

La description révèle le comportement de sortie : 'Retourne le prix et le stock de chaque résultat', ce qui est utile car aucune annotation n'est fournie. Elle ne mentionne pas la pagination ou les autorisations, mais pour un outil de recherche en lecture seule, cela suffit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

La description tient en trois phrases, chacune ayant un rôle distinct : objet et critères de recherche, cas d'utilisation, et résultat renvoyé. Aucun mot superflu, la structure est front-loadée avec l'action principale.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

L'outil est simple : le schéma décrit les deux paramètres, et la description explique ce que renvoie l'outil. Il manque une mention explicite du filtre par catégorie, mais il est dans le schéma, donc l'ensemble est suffisant.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

La couverture du schéma est de 100% : les deux paramètres (query et category) ont des descriptions. La mention 'par nom, code ou marque' dans la description répète simplement la description du paramètre query sans ajouter de valeur supplémentaire par rapport au schéma.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

La description commence par 'Rechercher des produits dans le catalogue', ce qui indique clairement l'action (recherche) et la ressource (produits). Elle précise les critères de recherche (nom, code, marque) et se distingue de ses outils frères comme get_item_stock ou get_low_stock_items, qui sont des recherches ciblées de stock.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

La description fournit des cas d'utilisation explicites : 'pour trouver un produit avant une vente, avant une commande fournisseur, ou pour vérifier si un produit existe dans le système'. Elle ne mentionne pas explicitement quand ne pas l'utiliser ni d'outils alternatifs, mais le contexte d'utilisation est clair.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.