swisstopo_query_osm_features

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

Die Anmerkungen lesen sich als readOnlyHint, openWorldHint, idempotentHint und destructiveHint false. Die Beschreibung fügt hinzu, dass die Quelle OpenStreetMap (ODbL) ist und nicht swisstopo, und dass Overpass Rate-Limits/Timeouts hat, weshalb ein kleinerer Radius bevorzugt werden sollte. Dies geht über die Annotationen hinaus und schafft Verhaltens-Transparenz, inklusive möglicher Fehlermeldungen.

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?

Die Beschreibung ist kompakt: ein einleitender Satz, gefolgt von klar strukturierten Abschnitten use_case und important_notes. Jede Zeile liefert einen Mehrwert, ohne überflüssige Wiederholungen. Die Struktur mit XML-Tags erleichtert das Parsing.

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?

Das Tool hat 4 Parameter und eine Ausgabe-Schema, daher muss die Beschreibung nur den Kontext und die Besonderheiten abdecken. Sie erklärt die externe Datenquelle, den Anwendungsfall, die Einschränkungen von Overpass und das Fehlerverhalten. Das ist für ein Such-Werkzeug eine vollständige Beschreibung.

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?

Obwohl das Schema für alle vier Parameter Beschreibungen enthält (area, limit, radius_m, feature_type), liefert die Tool-Beschreibung keine zusätzliche syntaktische Information. Sie erwähnt jedoch den Suchradius und die POI-Kategorien im Fließtext, was den Zweck der Parameter kontextualisiert. Das Schema trägt die Hauptlast, daher ist 3 angemessen.

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?

Die Beschreibung nennt das Verb 'Findet', die Ressource 'OpenStreetMap-POIs' und den Kontext 'im Umkreis'. Beispiele wie Schulen, Spielplätze und Apotheken machen den Zweck konkret. Sie grenzt sich von den amtlichen swisstopo-Daten ab und ist klar von den Geschwister-Tools unterscheidbar.

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?

Das use_case-Feld definiert genau, wann das Tool eingesetzt wird: für die Beantwortung von Umkreisfragen nach POIs. important_notes gibt zusätzlich Hinweise zu Overpass-Limits und Fehlerverhalten, was eine informierte Nutzung ermöglicht. Alternativen werden zwar nicht explizit genannt, aber der Zusatz 'Ergänzt die amtlichen swisstopo-Daten' impliziert die Abgrenzung.

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