Tool Schema Tasarımı

Altın kurallar:

1. Single responsibility — bir tool bir iş yapsın. search_and_summarize yerine search + summarize.
2. Description = micro-tutorial — "Ne yapar, ne zaman çağrılmalı, ne zaman ÇAĞRILMAMALI" üçlüsünü ekle.
3. Enum'lar string'den iyi — difficulty: "easy" | "medium" | "hard" model'i sınırlandırır.
4. Each param için description — boş bırakma. Model description'ı okur.
5. Examples (input_schema dışında) — kompleks tool'larda 1-2 örnek call ekle (system prompt'ta).
6. Required minimum — opsiyonel olabilecek her şey opsiyonel olsun, model overhead'i azalır.
7. Output format predictable — model tool sonucunu yorumlayacak; tutarlı format şart.