Détails d'un(e) ressource

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

Les annotations indiquent readOnlyHint=true, destructiveHint=false, idempotentHint=true, ce qui correspond à une opération de lecture sûre. La description ajoute que le outil retourne des données JSON complètes, ce qui informe sur le format de sortie. Il n'y a pas de contradiction avec les 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 est concise : deux phrases principales, l'essentiel est front-loaded avec le but. Chaque phrase apporte une information utile (récupération par ID, onglet optionnel, format de retour). Aucune redondance.

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 simple avec deux paramètres et des annotations complètes, la description est suffisante. Elle couvre le but, les paramètres principaux et le type de retour. Cependant, aucun détail sur les contraintes d'utilisation ou les cas d'échec n'est fourni, ce qui laisse une légère marge d'amélioration.

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. La description répète presque textuellement les valeurs autorisées pour le paramètre 'tab'. Elle n'ajoute pas de signification supplémentaire par rapport au schéma, donc le score est basé sur la couverture élevée (baseline 3).

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 indique clairement que le outil récupère les informations détaillées d'une ressource par son ID, avec un onglet optionnel. Le verbe 'Récupère' et l'objet 'ressource' sont précis, et la mention de l'onglet distingue ce outil des autres outils de recherche ou de mise à jour.

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 ne donne pas d'indications explicites sur quand utiliser ce outil par rapport aux alternatives comme boond_resources_information ou boond_resources_search. L'onglet optionnel est mentionné, mais sans guider l'utilisateur sur le choix entre ce outil et d'autres outils spécialisés.

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