Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

JSON garantuotas pagal schemą

Paskaita 1 iš 12 Atnaujinta 2026 m. liepos 28 d. Kūrėjas
Šiame puslapyje
  1. Kodėl struktūrizuota išvestis keičia viską
  2. Kaip tai veikia
  3. Prieinamumas
  4. Be struktūrizuotos išvesties ir su ja
  5. Du galimi būdai
  6. Svarbiausi punktai

Kodėl struktūrizuota išvestis keičia viską

Naudojant kalbos modelius gamybinėje aplinkoje, tau reikia atsakymų, kuriuos gali tiesiogiai naudoti kodas. Ne laisvo teksto, ne apytikslio JSON – tau reikia JSON, garantuotai atitinkančio tavo apibrėžtą schemą. Būtent tai tau siūlo „Grok API“ struktūrizuota išvestis.

Principas paprastas: modeliui pateiki JSON schemą, o API garantuoja, kad atsakymas tiksliai atitiks šią struktūrą. Jokių atsitiktinių parsavimų, jokių trapių reguliariųjų išraiškų, jokių try/catch blokų situacijoms, kai modelis sugalvoja savo formatą.

Kaip tai veikia

Struktūrizuota išvestis remiasi apribojimo mechanizmu, taikomu teksto generavimo metu. Kiekvieno sugeneruoto tokeno metu modelis priverstas rinktis tik tuos tokenus, kurie suderinami su pateikta schema. Rezultatas – JSON, kuris visada yra validus ir visada atitinka reikalavimus.

Pažvelkime į konkretų pavyzdį. Tarkime, nori išgauti kontaktinę informaciją iš el. laiško:

from pydantic import BaseModel

class Contact(BaseModel):
    nom: str
    email: str
    entreprise: str
    telephone: str | None

# Atsakymas VISADA bus validus Contact objektas

Be struktūrizuotos išvesties modelis gali grąžinti telefono numerį kaip "tel", "phone" arba "numéro". Naudojant schemą, laukas visada bus vadinamas telephone, o jo reikšmė visada bus eilutė arba null.

Prieinamumas

Struktūrizuota išvestis palaikoma visuose xAI kalbos modeliuose: „Grok 4.5“, „Grok 4.3“, „grok-4.20“ variantuose ir vėlesnėse versijose. Nesvarbu, kurį modelį naudosite, ši funkcija prieinama be papildomų išlaidų ar konfigūracijos.

100%
Garantuotai validus JSON
7
Palaikomi tipai
Visi
xAI modeliai
2
Kvietimo metodai

Be struktūrizuotos išvesties ir su ja

Štai ką gauni be šios funkcijos ir ją naudojant:

Be struktūrizuotos išvesties:

  • Modelis gali grąžinti laisvą tekstą, dalinį JSON arba netikėtą formatą
  • Turi parsavimą atlikti rankiniu būdu ir apdoroti klaidas
  • Laukų pavadinimai gali skirtis nuo vieno užklausos kito
  • Tavo duomenų srautas sutrinka, kai tik modelis pakeičia formatą

Su struktūrizuota išvestimi:

  • JSON yra visada sintaksiškai validus
  • Struktūra tiksliai atitinka pateiktą schemą
  • Tipai yra gerbiami (eilutė, skaičius, loginė reikšmė ir kt.)
  • Tavo kodas gali tiesiogiai naudoti atsakymą

Du galimi būdai

„Grok API“ siūlo du metodus struktūrizuotai išvesčiai naudoti:

  • parse(): Automatinis metodas, kuris tiesiogiai grąžina tipizuotą objektą. Idealus daugeliu atvejų.
  • response_format: Rankinis metodas, kuris grąžina JSON eilutę. Suteikia daugiau kontrolės, tačiau parsavimą turi atlikti pats.

Šiuos du metodus išsamiai nagrinėsi artimiausiose pamokose.

Svarbiausi punktai

  • Struktūrizuota išvestis garantuoja, kad JSON atitiks tavo schemą kiekvieno kvietimo metu
  • Apribojimas taikomas generavimo metu, o ne po jo
  • Visi xAI kalbos modeliai palaiko šią funkciją
  • Galimi du metodai: parse() (automatinis) ir response_format (rankinis)
  • Tai yra bet kokio patikimo gamybinio srauto su „Grok API“ pagrindas