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

Les annotations couvrent déjà la lecture seule, l'idempotence et la non-destructivité. La description ajoute utilement le périmètre détaillé du retour, les champs couverts et la présence de trois modèles similaires, ce qui va au-delà des annotations.

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 une phrase et chaque élément apporte une information utile, notamment la longue énumération des champs qui compense l'absence de schéma de sortie. La phrase d'usage est bien placée en fin, mais l'énumération rend l'ensemble un peu dense.

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?

En l'absence de schéma de sortie, la description liste de façon détaillée ce que renvoie l'outil et précise quand l'utiliser. Il manque seulement le comportement en cas d'identifiant inconnu ou des précisions sur d'éventuels frais, mais l'essentiel est couvert.

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?

Le schéma documente déjà l'unique paramètre id avec un exemple concret, soit une couverture de 100 %. La description ajoute seulement que l'id est obtenu via search_chalets, ce qui est un léger complément mais ne change pas le niveau de base.

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 précise un verbe concret (« renvoie la fiche complète d'un modèle »), la ressource visée (un chalet via son id) et le contenu exact du retour. Elle distingue l'outil de search_chalets en indiquant que l'id provient de celui-ci.

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 donne un contexte d'utilisation clair : « À utiliser avant de recommander un modèle précis ou de répondre à une question de détail ». Elle rattache aussi l'obtention de l'id à search_chalets, mais ne nomme pas explicitement d'alternative à éviter.

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