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

Die Annotationen zeigen bereits readOnlyHint=true und destructiveHint=false; die Beschreibung ergänzt wichtige Verhaltensdetails zur Datenfrische, zum Zeitstempel in der Antwort und zur möglichen Verzögerung neu gesetzter Records. Zusätzlich wird die Einschränkung der Live-Alternative auf turbopress-Nameserver transparent gemacht.

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?

Der Zweck steht voran, danach folgen Aktualitätshinweis und Alternative. Die Beschreibung ist dicht, aber ohne überflüssige Sätze und gut auf die Entscheidung des Agents ausgerichtet.

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?

Für ein Tool mit einem Parameter, klaren Read-only-Annotationen und ohne Output-Schema ist die Beschreibung ausreichend vollständig. Sie deckt Zweck, Datenquelle, Aktualitätsgrenze und Alternative ab.

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?

Der einzige Parameter domain ist im Schema bereits vollständig beschrieben, inklusive Beispiel. Die Tool-Beschreibung fügt dazu keine wesentliche zusätzliche Syntax oder Formatinformation hinzu, daher ist die Baseline von 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 ein klares Verb und Ressourcenobjekt: DNS-Mail-Sicherheitseinstellungen einer Domain abrufen, mit SPF/DKIM/DMARC/MX. Sie grenzt das Tool außerdem explizit von get_dns_records ab.

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?

Sie erklärt klar, wann dieses Tool passt: Daten stammen aus dem täglich aktualisierten turbocheck-Bericht, neue Records können erst nach dem nächsten Lauf erscheinen. Für sofort aktuelle Zonendaten wird ausdrücklich get_dns_records als Alternative genannt, inklusive der Bedingung, dass die Nameserver bei turbopress liegen müssen.

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