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

L'annotation readOnlyHint couvre déjà la sûreté en lecture; la description ajoute des détails comportementaux importants: source des donnéees, méthodologie de la médiane communale, et limites (ignore étage, état, DPE). Cela va bien au-delà de l'annotation seule.

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?

Quatre phrases denses et utiles, avec la définition en tête, suivie du cas d'usage, des exigences d'entrée et de l'avertissement. Aucune phrase superflue; l'information est bien hiérarchisée.

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?

Pour un outil de lecture sans schéma de sortie, la description fournit tout le nécessaire: source des données, alternatives d'entrée, année par défaut et limite d'interprétation. Le format de retour est suffisamment implicite pour un outil d'estimation.

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 couvre 100% des paramètres avec des descriptions complètes, y compris les valeurs par défaut et les règles d'ignorance quand property_id est fourni. La description répète le groupe 'soit property_id, soit commune + type + surface' sans apporter de nouvelle sémantique paramétrique. La note de base de 3 est donc appropriée.

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 un verbe et un objet spécifiques ('Estime la valeur vénale d'un logement') et précise la méthode à partir des ventes réelles DVF, ce qui la distingue clairement des outils de calcul, de comptabilité et de liste. Elle ne répète pas simplement le nom de l'outil et ajoute une vraie substance.

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 indique précisément quand l'utiliser (base amortissable quand le bien était détenu avant mise en location) et précise explicitement que ce n'est pas une expertise. Elle explique aussi les deux modes de saisie valides, mais ne nomme pas d'ouil alternatif parmi les frères.

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