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

Opis wnosi realną wartość ponad adnotacje (readOnly/idempotent/openWorld): ujawnia semantykę wygasania ceny przez znaczniki `cena_wazna_od`/`cena_wazna_do`, zależność wyniku od stanu magazynowego oraz to, że odpowiedź zawiera koszt dostawy. Nie opisuje natomiast zachowania przy braku SKU ani formatu błędów.

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?

Trzy zdania, wszystkie niosą informację: co zwraca, kiedy cena wygasa, jakie jest zastrzeżenie o terminie płatności. Gęste nawiasy i wtrącenia lekko utrudniają czytanie, ale nic nie jest zbędne.

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?

Brak output schema, więc opis musi udźwignąć kształt odpowiedzi — i robi to częściowo, wymieniając cztery zwracane pola (cena od, cena od ręki, znaczniki ważności, koszt dostawy). Nie wyjaśnia jednak struktury odpowiedzi ani zachowania przy nieistniejącym SKU.

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?

Pokrycie opisów w schemacie to 33% — tylko `waluta` ma opis, a enum i tak jest samowyjaśniający. Opis wyjaśnia sens `sku` i `waluta`, ale całkowicie pomija parametr `ilosc`, który najpewniej wpływa na próg cenowy; przy niskim pokryciu schematu to odczuwalna luka.

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?

Stany wyraźny czasownik i zasób: bieżąca cena produktu po SKU, z rozróżnieniem ceny 'od' (7-10 dni) i 'od ręki' (24-48 h). Wyraźnie odcina się od get_buyback_price przez wskazanie, że chodzi o cenę sprzedaży, ale nie wymienia po nazwie żadnego z narzędzi siostrzanych (np. check_availability przy warunku 'jeśli na stanie').

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?

Podaje konkretny warunek użycia i ponownego użycia: po `cena_wazna_do` cena jest NIEAKTUALNA i trzeba ją pobrać ponownie przed pokazaniem klientowi. Dodatkowo ostrzega, że termin płatności 24h nie jest gwarancją ceny. Brak jedynie jawnego wskazania alternatywy (np. 'stan magazynowy sprawdź przez check_availability').

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