JSON

Definicja

JSON to format zapisu danych, który łatwo czytają programy i da się go przeczytać człowiekowi. Nazwa to skrót od „JavaScript Object Notation”. Format opisuje standard RFC 8259, a prosty opis po polsku jest na json.org.

Przykład:

{
  "imie": "Anna",
  "dzial": "Sprzedaż",
  "szkolenia": ["WCAG", "AI w praktyce"],
  "aktywna": true
}

Co to w zasadzie jest?

Dane w parach „nazwa: wartość”, w nawiasach klamrowych { }.
Listy w nawiasach kwadratowych [ ].
Tekst zawsze w cudzysłowach, liczby i true/false bez.
Jest bezlitosny dla drobnych błędów: brakujący przecinek albo cudzysłów psuje cały plik.

Gdzie go spotykasz

Programy i API wymieniają się danymi w JSON-ie (API).
Pliki ustawień wielu aplikacji, także narzędzi AI.
Structured output: gdy prosisz model o odpowiedź w ustalonym formacie do dalszej obróbki, to najczęściej JSON.
Aplikacje w przeglądarce zapisują w JSON-ie stan i szkice użytkownika.

Praktyczne zastosowania (konkretne scenariusze)

Scenariusz 1: Wyciąganie danych z maili

Cel: rejestr zgłoszeń w arkuszu.
Wejście: treść maili (bez danych osobowych albo w zatwierdzonym narzędziu).
Kroki: model zwraca dla każdego maila JSON z polami: temat, data, priorytet → skrypt wpisuje dane do arkusza.
Rezultat: uporządkowany rejestr.
Zabezpieczenie: walidacja JSON-a i kontrola próbki przez człowieka.

Scenariusz 2: Czytanie pliku ustawień

Cel: sprawdzić, jak skonfigurowane jest narzędzie.
Wejście: plik .json z ustawieniami.
Kroki: znajdź właściwą nazwę i jej wartość, np. "autoUpdates": false.
Rezultat: wiesz, co jest włączone, a co nie.
Zabezpieczenie: kopia pliku przed edycją.

Typowe błędy i pułapki

Brakujący przecinek albo przecinek po ostatnim elemencie.
Pojedyncze cudzysłowy zamiast podwójnych.
Model, który dopisuje komentarz przed JSON-em albo po nim, przez co program go nie odczyta.

Ryzyka i jak je ograniczać

Ryzyko 1: Zepsuty plik ustawień

Ryzyko: jedna literówka i aplikacja nie startuje.
Jak ograniczać: kopia przed edycją, sprawdzenie w walidatorze JSON.

Ryzyko 2: Błędne dane z modelu

Ryzyko: poprawny format, ale zmyślone wartości.
Jak ograniczać: walidacja wyniku i kontrola człowieka.

Checklista “zanim użyjesz”

Czy plik przechodzi walidację?
Czy model zwraca sam JSON, bez komentarzy?
Czy wartości zostały sprawdzone na próbce?

Diagram

flowchart LR
    A[Program lub model AI]
    B[JSON]
    C[Inny program lub API]
    D[Walidacja]
    A --> B --> D --> C

Diagram pokazuje, że JSON służy do przekazywania danych między programami, a przed użyciem warto go sprawdzić walidacją.