JSON zajamčen shemom
Na ovoj stranici
Zašto strukturirani izlazi mijenjaju sve
Kada koristiš jezični model u proizvodnji, trebaju ti odgovori koje tvoj kod može izravno koristiti. Ne slobodan tekst, ne približan JSON – već JSON zajamčeno usklađen sa shemom koju ti definiraš. Upravo to ti nudi Grok API sa svojim strukturiranim izlazima.
Princip je jednostavan: modelu dostaviš JSON shemu, a API jamči da će odgovor točno slijediti tu strukturu. Nema nasumičnog parsiranja, nema krhkih regularnih izraza, nema blokova try/catch za rukovanje slučajevima gdje model izmisli vlastiti format.
Kako to funkcionira
Strukturirani izlazi oslanjaju se na mehanizam ograničenja primijenjen tijekom generiranja teksta. Pri svakom proizvedenom tokenu, model je ograničen tako da generira isključivo tokene kompatibilne s dostavljenom shemom. Rezultat? JSON koji je uvijek valjan i uvijek usklađen.
Pogledajmo konkretan primjer. Želiš izvući kontakt podatke iz e-pošte:
from pydantic import BaseModel
class Contact(BaseModel):
nom: str
email: str
entreprise: str
telephone: str | None
# Odgovor će UVJEK biti valjan objekt Contact
Bez strukturiranih izlaza, model bi mogao vratiti telefonski broj pod ključem "tel", "phone" ili "numéro". Uz shemu, polje će se uvijek zvati telephone, a njegova vrijednost bit će uvijek niz znakova ili null.
Dostupnost
Strukturirani izlazi podržani su na svim jezičnim modelima tvrtke xAI: Grok 4.5, Grok 4.3, varijante grok-4.20 i novije verzije. Koji god model koristio, značajka je dostupna bez dodatnih troškova ili konfiguracije.
Bez naspram sa strukturiranim izlazima
Evo što dobivaš bez ove značajke, a što s njom:
Bez strukturiranih izlaza:
- Model može vratiti slobodan tekst, djelomični JSON ili neočekivani format
- Moraš ručno parsirati i rukovati greškama
- Nazivi polja mogu varirati od jednog zahtjeva do drugog
- Tvoj pipeline puca čim model promijeni format
Sa strukturiranim izlazima:
- JSON je uvijek sintaksno valjan
- Struktura točno odgovara dostavljenoj shemi
- Tipovi su poštovani (niz, broj, boolean itd.)
- Tvoj kod može izravno konzumirati odgovor
Dva dostupna pristupa
Grok API nudi dvije metode za korištenje strukturiranih izlaza:
parse(): Automatska metoda koja izravno vraća tipizirani objekt. Idealna za većinu slučajeva.response_format: Ručna metoda koja vraća JSON niz. Pruža veću kontrolu, ali parsiranje je na tebi.
Ove dvije metode detaljno ćeš otkriti u nadolazećim lekcijama.
Ključne točke
- Strukturirani izlazi jamče JSON usklađen s tvojom shemom pri svakom pozivu
- Ograničenje se primjenjuje tijekom generiranja, a ne nakon njega
- Svi jezični modeli tvrtke xAI podržavaju ovu značajku
- Dostupne su dvije metode:
parse()(automatska) iresponse_format(ručna) - Ovo je temelj svakog pouzdanog produkcijskog pipelinea s Grok API-jem