Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

JSON garantēts ar shēmu

Nodarbība 1 no 12 Atjaunota 2026. gada 28. jūlijs Programmētājs
Šajā lapā
  1. Kāpēc strukturētās izvades maina visu
  2. Kā tas darbojas
  3. Pieejamība
  4. Bez strukturētajām izvādēm un ar tām
  5. Divas pieejamās pieejas
  6. Galvenās atziņas

Kāpēc strukturētās izvades maina visu

Kad ražošanas vidē izmanto valodu modeli, tev ir nepieciešamas atbildes, ko kods var izmantot. Ne brīvs teksts, ne aptuvens JSON — bet JSON, kas garantēti atbilst tavai definētajai shēmai. Tieši to piedāvā Grok API strukturētās izvades.

Princips ir vienkāršs: tu nodro modeli ar JSON shēmu, un API garantē, ka atbilde precīzi sekos šai struktūrai. Nekāda haotiska parsēšana, nekādu trauslu regulāro izteiksmju, nekādu try/catch bloku, lai apstrādātu gadījumus, kad models izgudro savu formātu.

Kā tas darbojas

Strukturētās izvades balstās uz ierobežošanas mehānismu, kas tiek piemērots teksta ģenerēšanas laikā. Katrā ģenerētajā tokenī models ir ierobežots, lai radītu tikai tokenus, kas saderīgi ar norādīto shēmu. Rezultāts: JSON, kas vienmēr ir derīgs un vienmēr atbilst prasībām.

Aplūkosim konkrētu piemēru. Tu vēlies no e-pasta izvilkt kontaktinformāciju:

from pydantic import BaseModel

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

# Atbilde VIENMĒR būs derīgs Contact objekts

Bez strukturētajām izvādēm models varētu atgriezt tālruņa numuru kā "tel", "phone" vai "numéro". Ar shēmu lauks vienmēr tiks saukts par telephone, un tā vērtība vienmēr būs virkne vai null.

Pieejamība

Strukturētās izvades tiek atbalstītas visos xAI valodu modeļos: Grok 4.5, Grok 4.3, grok-4.20 variantos un jaunākās versijās. Neatkarīgi no tā, kuru modeli izmanto, šī funkcija ir pieejama bez papildu maksas vai papildu konfigurācijas.

100%
Garantēti derīgs JSON
7
Atbalstītie tipi
Visi
xAI modeļi
2
Izsaucamās metodes

Bez strukturētajām izvādēm un ar tām

Lūk, ko tu iegūsti bez šīs funkcijas un ar to:

Bez strukturētajām izvādēm:

  • Models var atgriezt brīvu tekstu, daļēju JSON vai negaidītu formātu
  • Tev tas ir jāparsē manuāli un jāapstrādā kļūdas
  • Lauku nosaukumi var atšķirties no viena pieprasījuma uz otru
  • Tava darbplūsma sabrūk, tiklīdz models maina formātu

Ar strukturētajām izvādēm:

  • JSON ir vienmēr sintaktiski derīgs
  • Struktūra precīzi atbilst norādītajai shēmai
  • Tipi tiek ievēroti (virkne, skaitlis, boolean utt.)
  • Tavs kods var patērēt atbildi tieši

Divas pieejamās pieejas

Grok API piedāvā divas metodes strukturēto izvadu izmantošanai:

  • parse(): Automātiska metode, kas tieši atgriež tipizētu objektu. Ideāli piemērota vairumam gadījumu.
  • response_format: Manuāla metode, kas atgriež JSON virkni. Nodrošina lielāku kontroli, bet parsēšana ir tava ziņā.

Šīs divas metodes tu detalizēti apgūsi nākamajās nodarbībās.

Galvenās atziņas

  • Strukturētās izvades garantē JSON, kas atbilst tavai shēmai, katrā izsaukumā
  • Ierobežojums tiek piemērots ģenerēšanas laikā, nevis pēc tās
  • Visi xAI valodu modeļi atbalsta šo funkciju
  • Pieejamas divas metodes: parse() (automātiska) un response_format (manuāla)
  • Tas ir jebkuras uzticamas ražošanas darbplūsmas pamats, izmantojot Grok API