knowmind_link

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

Annotations zeigen idempotentHint=true und destructiveHint=false. Die Beschreibung ergänzt: 'Inverse Edges werden automatisch materialisiert', was über die Annotationen hinausgeht. Sie erwähnt außerdem die erforderliche Berechtigung (Scope write). Kein Widerspruch zu Annotationen.

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 als Absatz formuliert mit wichtigen Informationen vorn. Sie könnte strukturierter sein (z.B. Aufzählung), aber sie ist prägnant und ohne unnötige Wiederholungen. Jeder Satz trägt zur Nutzbarkeit bei.

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 der Komplexität (verschiedene Kantentypen, 4 Parameter, kein Ausgabe-Schema) deckt die Beschreibung die wesentlichen Aspekte ab: Zweck, Typen, Einschränkungen, Verhalten inverser Kanten und Autorisierung. Es fehlen Details zu Fehlerbedingungen (z.B. wenn Knoten nicht existieren), aber insgesamt ist es ausreichend 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?

Die Schema-Abdeckung beträgt 100%, aber die Beschreibung fügt bedeutende Semantik hinzu: eine Liste erlaubter rel_type-Werte, explizites Verbot generischer Kanten und die Angabe des Standardwerts für confidence (1.0 für gepflegte Kanten). Dies geht weit über die Schema-Beschreibungen hinaus.

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 gibt klar an, dass das Werkzeug eine typisierte Beziehung zwischen zwei Memory-Knoten erstellt. Sie listet explizit erlaubte rel_type-Werte auf und verbietet generische Kanten, wodurch es sich von Geschwistern wie 'knowmind_unlink' (zum Löschen) und 'knowmind_store_memory' (zum Speichern von Knoten) unterscheidet.

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?

Die Beschreibung gibt klare Hinweise zur Verwendung: Erstellen von typisierten Kanten, Verbot generischer Kanten, und erforderlicher Schreibbereich. Sie gibt keine expliziten Alternativen an (wie 'verwende knowmind_unlink zum Entfernen'), aber der Kontext ist ausreichend.

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