Encyklopedia AI

JSON Schema: schemat danych JSON

JSON Schema to formalny opis tego, jak ma wyglądać poprawny obiekt JSON: jakie pola są wymagane, jakiego są typu i jakie wartości mogą przyjąć.

  • Automatyzacje
  • 2 min czytania
  • Aktualizacja:

W systemie AI zamienia luźną odpowiedź modelu w kontrakt dla automatyzacji, CRM lub formularza. Nie gwarantuje prawdziwości danych, ale pozwala odrzucić wynik, który ma złą strukturę, zanim trafi do kolejnego kroku.

JSON Schema to deklaratywny standard opisu i walidacji danych JSON. Zamiast liczyć, że aplikacja, formularz albo model AI zwróci „mniej więcej” właściwy obiekt, zapisujesz zasady: które pola muszą istnieć, czy wartość jest tekstem, liczbą, listą czy obiektem, jakie opcje są dozwolone i jakie ograniczenia mają obowiązywać. Schemat nie jest samymi danymi. Jest umową, według której dane można sprawdzić.

Dla eksperta budującego automatyzację z AI największa korzyść jest prosta: wynik modelu przestaje być tekstem do ręcznego przepisywania. Możesz oczekiwać na przykład obiektu leada z polami imię, e-⁠mail, problem, etap i następny_krok. Walidator wykryje brak e-⁠maila albo wartość spoza ustalonej listy etapów, zanim workflow utworzy błędny rekord w CRM, wyśle wiadomość lub uruchomi follow-⁠up.

Praktyczny przykład: agent analizuje odpowiedzi z formularza konsultacyjnego i ma przekazać je do bazy. Schemat wymaga pól „priorytet”, „temat” i „streszczenie”, ogranicza priorytet do niskiego, średniego albo wysokiego oraz ustawia maksymalną długość streszczenia. Model nadal interpretuje język klienta, ale system nie przyjmuje dowolnego kształtu odpowiedzi. Gdy walidacja nie przejdzie, zapisujesz błąd, prosisz model o korektę lub kierujesz przypadek do człowieka.

JSON Schema warto odróżnić od zwykłej instrukcji w promptcie. Polecenie „zwróć JSON z pięcioma polami” jest sugestią dla modelu. Schemat może zostać użyty przez API lub kod jako techniczna kontrola zgodności. Wiele platform AI oferuje ustrukturyzowane wyjście oparte na schemacie, ale szczegóły obsługi odmowy, przerwanej odpowiedzi i obsługiwanych słów kluczowych zależą od dostawcy. Przed wdrożeniem sprawdź jego aktualną dokumentację.

Sam poprawny schemat nie rozwiązuje problemu jakości. Model może zwrócić poprawny technicznie e-⁠mail, który nie istnieje, albo przypisać leadowi zły priorytet. Dlatego schemat łącz z kontrolami biznesowymi: weryfikacją domeny, regułami dopuszczalnych akcji, logiem wejścia i wyniku oraz zatwierdzeniem człowieka tam, gdzie stawką są pieniądze, reputacja lub dane klienta. Format odpowiedzi i prawdziwość odpowiedzi to dwa różne testy.

Na start nie buduj ogromnego uniwersalnego modelu danych. Wybierz jeden przepływ, nazwij pola po ludzku, oznacz tylko naprawdę wymagane wartości i przygotuj kilka realnych przykładów wejścia. Następnie przetestuj przypadek z brakiem danych, nietypową odpowiedzią i próbą podania wartości spoza listy. Jeśli wynik ma iść dalej w automatyzacji, połącz schemat z obsługą błędów oraz bezpiecznym ponowieniem zadania. Zobacz też: Ustrukturyzowane wyjście AI.

Najczęstsze pytania

Czy JSON Schema jest tym samym co JSON?

Nie. JSON to format zapisu danych, na przykład obiekt z nazwą i e-⁠mailem. JSON Schema opisuje zasady, które taki obiekt ma spełniać. Możesz więc użyć schematu do sprawdzenia, czy JSON ma wymagane pola, właściwe typy wartości i dopuszczalne opcje.

Czy JSON Schema zatrzymuje halucynacje AI?

Nie. Schemat pilnuje struktury, nie prawdziwości treści. Model może zwrócić obiekt zgodny ze schematem, ale z błędnym faktem lub złą interpretacją. Ważne decyzje wymagają dodatkowo wiarygodnego źródła danych, reguł biznesowych i w razie potrzeby zatwierdzenia przez człowieka.

Źródła

  1. JSON Schema: dokumentacja i wprowadzeniejson-schema.org (otwiera się w nowej karcie)
  2. OpenAI API: Structured Outputsplatform.openai.com (otwiera się w nowej karcie)

Powiązane wpisy

Ścieżka „Chcę budować automatyzacje”. Jak AI może korzystać z narzędzi, wykonywać kroki i wspierać powtarzalne zadania.

Chcesz więcej takich konkretów?

Co niedzielę wysyłam jeden praktyczny mail o AI, sprzedaży wiedzy i budowaniu systemów, które realnie pomagają w pracy.

Archiwum wydań

„Ten newsletter nie jest nachalny, urzeka autentycznością, a osobiste historie Bartka są świetnym punktem odniesienia do moich własnych doświadczeń.”
Małgorzata BabskaMałgorzata Babskaarchitektka

Chcesz konkret, a nie ogólną rozmowę o AI?

W 30 minut przechodzimy przez Twój biznes i mówię wprost, co zrobiłbym najpierw.

Prywatność i cookies

Odwiedziny liczę anonimowo. Za Twoją zgodą włączę analitykę i marketing, żeby wiedzieć, co działa. Polityka prywatności

Kategorie plików cookies