get_passage

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

Aucune annotation n'étant fournie, la description porte seule la charge de la transparence. Elle révèle des comportements importants : la valeur null de max_characters donne 15 000 caractères, l'ancien défaut tronquait 30,2 % des fenêtres, et les voisins ne sont pas filtrés comme les résultats de recherche. Elle précise aussi que les voisins en-tête sont des intitulés de section et sont déclarés dans la ligne « voisins : ».

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 dense et chaque phrase apporte une information utile. La phrase d'ouverture est immédiate, puis la liste des arguments structure clairement les détails. Même la note historique sur la troncature justifie sa place en expliquant pourquoi le défaut actuel est plus sûr.

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?

Un schéma de sortie existe, donc la description n'a pas besoin de documenter la valeur de retour. Elle couvre les trois paramètres, leurs défauts, les cas limites (neighbours=0) et le comportement des voisins. Pour un outil de lecture avec cette complexité, rien d'essentiel ne manque.

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 n'offre aucune description de paramètre (couverture 0 %), mais la description compense entièrement : chunk_id est expliqué comme une clé interne issue des outils de recherche, max_characters est défini avec sa valeur par défaut et son effet, et neighbours est décrit avec sa valeur par défaut et son comportement de filtrage.

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 précis (« Retourne ») et une ressource claire (« le passage complet d'un chunk_id »), avec l'objectif « pour citation ». Elle se distingue des outils de recherche comme search_documents et search_graph en se concentrant sur l'extraction d'un passage à partir d'une clé interne.

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 que chunk_id est « la clé interne rendue par search_documents ou search_graph », ce qui donne un contexte d'utilisation clair après une recherche. Elle mentionne l'usage pour citation, mais ne nomme pas explicitement d'alternatives ni de cas où ne pas utiliser cet outil.

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