JSON garantēts ar shēmu
Šajā lapā
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.
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) unresponse_format(manuāla) - Tas ir jebkuras uzticamas ražošanas darbplūsmas pamats, izmantojot Grok API