Porządek obrad posiedzenia Sejmu

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

Adnotacje pokrywają profil bezpieczeństwa (readOnlyHint, idempotentHint, destructiveHint=false), więc opis nie musi tego powtarzać. Wnosi jednak istotny kontekst zachowaniowy poza adnotacjami: semantykę braku numeru posiedzenia (bieżące/najbliższe) oraz to, że dla posiedzeń zakończonych zwracany jest porządek zrealizowany, co wpływa na interpretację wyniku. Brakuje informacji o ewentualnej paginacji mimo parametru od.

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?

Zwięzłe, jednoliniowe zdanie z front-loadingiem najważniejszej informacji (co to jest i jak traktować brak numeru). Każdy fragment zdania wnosi konkretną informację. Mimo to konstrukcja z nawiasami i wieloma myślnikami może utrudniać szybkie skanowanie.

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?

Biorąc pod uwagę, że istnieje output schema (opis nie musi wyjaśniać zwracanych wartości), adnotacje pokrywają bezpieczeństwo, a schemat opisuje parametry, opis uzupełnia kluczowe luki: semantykę trybu bez numeru oraz zachowanie dla posiedzeń zakończonych. Wystarczająco kompletny dla agenta, by poprawnie wywołać narzędzie, choć brak wskazania relacji z sąsiednimi narzędziami pozostawia niewielką niepewność.

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?

Schema ma 100% pokrycia opisami (od, kadencja, posiedzenie), więc zgodnie z regułą bazą jest 3. Opis dodaje jedynie znaczenie braku parametru posiedzenie (bieżące/najbliższe), co jest już częściowo odzwierciedlone w schemacie, ale nie wnosi nowych szczegółów formatu, zakresu wartości ani interakcji między kadencją a posiedzeniem.

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?

Precyzyjnie określa czasownik+zasób (porządek obrad posiedzenia Sejmu jako tekst) i natychmiast rozróżnia tryby działania: bez numeru (bieżące/najbliższe) vs z numerem (dowolne posiedzenie kadencji). W kontekście licznego rodzeństwa z rodziny posiedzeń (lista_posiedzen, glosowania_posiedzenia, wypowiedzi_posiedzenia) wyraźnie wskazuje na unikalny zwrot tekstowy porządku obrad, a nie metadane czy głosowania.

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?

Jasno opisuje warunki użycia: bez numeru posiedzenia dla bieżącego/najbliższego, z numerem dla dowolnego posiedzenia kadencji, z doprecyzowaniem że dla zakończonych to porządek zrealizowany. Nie wymienia jednak wprost alternatyw (np. lista_posiedzen do metadanych lub wypowiedzi_posiedzenia do treści), więc agent musi sam wywnioskować, kiedy sięgnąć po to narzędzie zamiast sąsiednich.

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