Skip to main content
Glama

Kto mówił na posiedzeniu Sejmu

wypowiedzi_posiedzenia
Read-onlyIdempotent

Retrieve and analyze Polish Sejm session speeches: filter by day, speaker, or committee rapporteur; count speeches per speaker including delivered and submitted.

Instructions

Spis wypowiedzi z jednego dnia posiedzenia Sejmu: numer, mówca, funkcja, godziny, czy mówca był sprawozdawcą komisji, czy wypowiedź była wygłoszona. Na pytanie „kto najczęściej zabierał głos” użyj zestawienie=true: liczba wypowiedzi na mówcę, osobno wygłoszone i niewygłoszone (złożone do protokołu), bez pobierania całego spisu. Z filtrem mowca (do 10 wypowiedzi) i z tylkoSprawozdawcy (pierwszych 40) przy każdej jest punkt porządku obrad, którego dotyczyła; czego serwer nie zdąży przeczytać, ma null i uwagę. Treść daje tresc_wypowiedzi. Filtr mowca szuka po nazwisku mówcy, nie po temacie; sprawozdawców pokazuje tylkoSprawozdawcy=true. Starsze dni rejestr oddaje wolno (nawet kilkanaście sekund). Wynik bywa niepełny (brak czasu, awaria Sejmu, limit): wtedy ma pole wynikCzesciowy i powiedz to użytkownikowi na początku odpowiedzi.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataNoDzień posiedzenia (RRRR-MM-DD); bez daty, razem z mowca albo tylkoSprawozdawcy, przeszukuje wszystkie dni posiedzenia
limitNoIle wyników najwyżej (domyślnie 100, max 300)
mowcaNoTylko wypowiedzi tej osoby (fragment nazwiska)
kadencjaNoNumer kadencji Sejmu; domyślnie 10 (bieżąca, od 13 listopada 2023)
posiedzenieYes
zestawienieNoZamiast spisu: liczba wypowiedzi na mówcę (wygłoszone i niewygłoszone osobno)
przesuniecieNoOd którego wyniku zacząć (stronicowanie)
tylkoSprawozdawcyNoTylko wystąpienia sprawozdawców komisji

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
uwagiNo
zrodlaYes
kalendarzNo
wynikCzesciowyNoTylko przy wyniku NIEPEŁNYM: powiedz to użytkownikowi na początku

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.3.0

TDQS

A4.8/5.0
Behavior5/5

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

Ujawnia istotne cechy poza adnotacjami: wolne działanie dla starszych dni (kilkanaście sekund), możliwy niepełny wynik z polem wynikCzesciowy i instrukcję powiadomienia użytkownika, ograniczenia filtrów (do 10 wypowiedzi, 40 sprawozdawców) oraz zachowanie przy braku daty.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Informacje są gęste i dobrze uporządkowane, ale tekst jest długi i miejscami wielowątkowy. Każde zdanie wnosi wartość, choć całość mogłaby być nieco bardziej zwięzła.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Przy 8 parametrach, bogatym schemacie i istniejącym output schema opis uzupełnia wszystkie krytyczne aspekty: tryby działania, filtry, ograniczenia, zachowanie przy błędach i wskazówki dla użytkownika.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema ma 88% pokrycia opisami, więc baseline to 3. Opis dodaje jednak semantykę wykraczającą poza schemat: co dokładnie filtruje mowca, jak działa zestawienie, co oznaczają null i uwaga przy braku punktu porządku obrad.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Precyzyjnie określa zasób (spis wypowiedzi z jednego dnia posiedzenia) i wyliczа zwracane pola (numer, mówca, funkcja, godziny, status sprawozdawcy). Wyraźnie odróżnia tryb domyślny od trybu zestawienie, co pozwala odróżnić narzędzie od siblingów typu glosowania_posiedzenia czy tresc_wypowiedzi.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Podaje konkretny warunek użycia zestawienie=true (pytanie „kto najczęściej zabierał głos”) oraz wskazuje tresc_wypowiedzi jako źródło treści wystąpień. Wyjaśnia też, kiedy filtr mowca jest właściwy, a kiedy mylący (szuka po nazwisku, nie temacie).

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