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

Les annotations fournissent readOnlyHint=true, signalant une opération en lecture seule, ce que la description confirme indirectement en disant que le texte est lu via Sefaria. Cependant, à part cette lecture, la description ne détaille pas le comportement : format exact de sortie, structure de la fiche, ou ce qui se passe si la référence est invalide. Elle ajoute peu au-delà de l'annotation de sécurité, donc score bas.

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 deux phrases, avec l'information clé (fonction, contenu de la fiche, source de texte) placée dès le début. L'ajout 'jamais de citation de mémoire' est un peu verbeux mais souligne la fiabilité. Pas de gaspillage majeur.

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?

Avec une complexité modérée (2 paramètres, schéma complet, annotations de lecture seule et pas de schéma de sortie), la description est minimale mais suffisante pour un usage simple. Cependant, elle manque de détails sur le format de sortie exact et sur l'interaction avec les autres outils (ex : comment obtenir des liens d'étude). Un agent aurait besoin de plus pour gérer des cas d'usage avancés.

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 : ref avec un exemple concret et segments avec sa valeur par défaut. La description ne renseigne pas davantage sur le format de ref ou l'effet de segments (par exemple, si segments=0 est autorisé). Le baseline de 3 est approprié, car la description ne compense pas au-delà du 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?

L'action est claire : composer une fiche source partageable incluant texte hébreu, traduction, référence exacte et liens d'étude. La description précise aussi qu'elle lit via Sefaria, apportant une spécificité utile. Toutefois, elle ne distingue pas explicitement des outils voisins comme sefaria_search ou sefaria_text, et le nom n'est pas évident pour un agent non francophone.

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 l'usage (créer une fiche à partager) mais ne précise pas quand utiliser cet outil plutôt que d'autres comme sefaria_text pour lire un texte ou sefaria_search pour trouver des références. Aucune condition d'exclusion ou alternative n'est mentionnée ; l'usage est implicite par le contexte de partage.

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