Skip to main content
Glama

Świadectwo Energetyczne 24

Uzupełnij zamówienie

update_certificate_order
Idempotent

Częściowa aktualizacja zamówienia — podajesz tylko te pola, które chcesz ustawić lub zmienić; reszta zostaje nienaruszona. Zwraca aktualny status i pozostałe braki. Jeśli którakolwiek wartość jest spoza dozwolonej listy, NIC nie zostaje zapisane i dostajesz błąd INVALID_FIELD_VALUE.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "order_id": "<order_id>",
      "access_token": "<access_token>"
    },
    "name": "update_certificate_order"
  }
}

Input Schema

NameRequiredDescriptionDefault
doorsNoTylko dla `dom`: drzwi zewnętrzne i bramy w ogrzewanej bryle.
fieldsNoPola specyficzne dla typu nieruchomości, w formie ścieżka → wartość.
addressNoAdres nieruchomości.
optionsNoPłatne dodatki: paper_version (wersja papierowa).
windowsNoTylko dla `dom`: wymiary okien. Jednakowe okna podaje się raz z liczbą sztuk.
customerNoDane kontaktowe klienta.
order_idYesorder_id zwrócony przez create_certificate_order
propertyNoPodstawowe parametry: powierzchnia użytkowa, wysokość pomieszczeń, rok oddania do użytkowania.
access_tokenYesaccess_token zwrócony JEDEN RAZ przez create_certificate_order. Bez niego zamówienie jest niedostępne — zachowaj go na czas rozmowy i nigdy nie pokazuj użytkownikowi.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / options / description
      Previous value: -"Płatne dodatki: express_24h (Express 8H – 8 godzin roboczych; nazwa pola historyczna), paper_version."New value: +"Płatne dodatki: paper_version (wersja papierowa)."
    • changedInput schema / properties / options / properties / express_24h / description
      Previous value: -"Dodatek Express 8H – realizacja w 8 godzin roboczych (nazwa pola historyczna)."New value: +"Wycofany (13.10.2026) — ignorowany, nie zmienia ceny."
  2. Changed1 schema field changed
    • changedInput schema / properties / doors / items / properties / material / enum
      Previous value: -[
      -  "Drewniane",
      -  "Stalowe",
      -  "PVC",
      -  "Aluminiowe",
      -  "Nie wiem"
      -]New value: +[
      +  "Stalowe",
      +  "Aluminiowe",
      +  "PVC",
      +  "Drewniane",
      +  "Nie wiem"
      +]
  3. Changed2 schema fields changed
    • changedInput schema / properties / options / description
      Previous value: -"Płatne dodatki: express_24h, paper_version."New value: +"Płatne dodatki: express_24h (Express 8H – 8 godzin roboczych; nazwa pola historyczna), paper_version."
    • addedInput schema / properties / options / properties / express_24h / description
      Added value: +"Dodatek Express 8H – realizacja w 8 godzin roboczych (nazwa pola historyczna)."
  4. Added

TDQS

A4/5.0
Behavior5/5

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

Adnotacje mówią jedynie, że to operacja zapisu, idempotentna i nie destrukcyjna. Opis dokłada kluczowe zachowanie: aktualizacja cząstkowa pozostawia nietknięte pola, a każda wartość spoza dozwolonej listy powoduje, że NIC nie zostaje zapisane (atomowość transakcji z błędem INVALID_FIELD_VALUE). To wartościowa informacja wykraczająca poza adnotacje.

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

Conciseness5/5

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

Trzy zdania, każde wnosi osobną wartość: semantyka aktualizacji cząstkowej, zawartość odpowiedzi oraz zachowanie przy błędzie. Informacja o zakresie zmiany jest na pierwszym miejscu, zero waty.

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

Completeness4/5

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

Brak schematu wyjściowego, więc opis słusznie informuje, co narzędzie zwraca (aktualny status i pozostałe braki). Przy dziewięciu parametrach i zagnieżdżonej strukturze definicja jest niemal kompletna; drobnym brakiem jest nieomówienie wymogu access_token i relacji do get_certificate_order_requirements, choć schemat to częściowo pokrywa.

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

Parameters3/5

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

Pokrycie opisami schematu wynosi 100%, więc schemat sam dokumentuje wszystkie dziewięć parametrów, w tym zagnieżdżone obiekty. Opis nie dodaje szczegółów składni ani formatu pól ponad to, co już jest w schemacie — baseline 3.

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

Purpose4/5

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

Precyzyjnie określa czasownik i zasób ("Częściowa aktualizacja zamówienia"), a kwalifikator "częściowa" odróżnia narzędzie od create_certificate_order i get_certificate_order bez otwierania schematu. Brak jednak jawnego wskazania rodzeństwa po nazwie, co powstrzymuje przed pełną piątką.

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

Usage Guidelines3/5

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

Wyjaśnia sposób użycia ("podajesz tylko te pola, które chcesz ustawić lub zmienić") i sugeruje, że order_id pochodzi z create_certificate_order, ale nie mówi wprost, kiedy wybrać to narzędzie zamiast alternatyw ani jakie są warunki wstępne. Wskazówki są dorozumiane, nie jawne.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.