swisstopo_convert_coordinates

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

Die Annotationen liefern bereits readOnlyHint, idempotentHint und destructiveHint=false. Die Beschreibung ergänzt darüber hinaus das kritische Verhalten: die Achsenreihenfolge je Richtung und dass vertauschte Achsen abgewiesen statt stillschweigend umgerechnet werden. Das geht deutlich über die Annotationen hinaus.

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 kurz, in use_case und important_notes strukturiert und enthält keine überflüssigen Wiederholungen. Jeder der drei Abschnitte liefert direkt verwertbare Information.

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?

Angesichts eines vorhandenen Output-Schemas und der ausführlichen Annotationen deckt die Beschreibung alle relevanten Aspekte ab: Anwendungsfall, Richtung, Achsenfehler und Fehlerverhalten. Für einen koordinatenbasierten Umrechnungs-Tool ist sie damit vollständig.

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 Tool-Schema laut Signal eine Beschreibungsabdeckung von 0% hat, enthält die Tool-Beschreibung die wichtigste Parameter-Semantik: easting/northing sind richtungsabhängig, und bei wgs84_to_lv95 ist easting der Längengrad und northing der Breitengrad. Die Enum-Werte und Einheiten bleiben dem Schema überlassen, aber der kritische Verwechslungsfall wird klar kompensiert.

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 konkrete Verb 'umrechnen' und die Zielsysteme WGS84 und LV95, ergänzt durch den offiziellen Dienstnamen REFRAME. Damit ist der Zweck eindeutig und klar von den übrigen swisstopo-Tools abgegrenzt.

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-Tag beschreibt explizit, wann die Umrechnung benötigt wird: um LV95-Koordinaten für andere Tools nach WGS84 zu bringen oder umgekehrt für den Katasterbezug. Es wird keine Alternative genannt, da auch unter den Geschwister-Tools kein direkter Koordinaten-Umrechner existiert; die Einsatzbedingung ist hinreichend klar.

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