Премини към основното съдържание
Български— Изберете език
Меню

JSON с гаранция за съответствие със схема

Урок 1 от 12 Обновен 28 юли 2026 г. Програмист
На тази страница
  1. Защо структурираните изходи променят всичко
  2. Как работи
  3. Наличност
  4. Без срещу със структурирани изходи
  5. Два налични подхода
  6. Ключови изводи

Защо структурираните изходи променят всичко

Когато използвате езиков модел в производствена среда, Ви трябват отговори, които кодът може да използва директно. Не свободен текст, не приблизителен JSON, а JSON, гарантирано съвместим със схема, която Вие дефинирате. Точно това Ви предлагат структурираните изходи на Grok API.

Принципът е прост: предоставяте JSON схема на модела и API гарантира, че отговорът ще следва тази структура прецизно. Никакво хаотично анализиране, никакви крехки регулярни изрази, никакви блокове try/catch за справяне със случаи, в които моделът измисля собствен формат.

Как работи

Структурираните изходи разчитат на механизъм за ограничения, приложен по време на генерирането на текста. При всеки произведен токен моделът е ограничен да генерира само токени, съвместими с предоставената схема. Резултатът: JSON, който винаги е валиден и винаги съвместим.

Нека разгледаме конкретен пример. Искате да извлечете контактна информация от имейл:

from pydantic import BaseModel

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

# The response will ALWAYS be a valid Contact object

Без структурирани изходи моделът може да върне телефонния номер като "tel", "phone" или "numéro". При наличие на схема името на полето винаги ще бъде telephone, а стойността му винаги ще бъде низ или null.

Наличност

Структурираните изходи се поддържат от всички езикови модели на xAI: Grok 4.5, Grok 4.3, варианти на grok-4.20 и по-нови версии. Независимо кой модел използвате, функцията е достъпна без допълнителни разходи или конфигурация.

100%
Guaranteed valid JSON
7
Supported types
All
xAI models
2
Call methods

Без срещу със структурирани изходи

Ето какво получавате без и с тази функция:

Без структурирани изходи:

  • Моделът може да върне свободен текст, частичен JSON или неочакван формат
  • Трябва да извършвате ръчно анализиране и да обработвате грешки
  • Имената на полетата могат да варират от една заявка до друга
  • Вашият конвейер се срива веднага щом моделът промени формата

Със структурирани изходи:

  • JSON винаги е синтактично валиден
  • Структурата съвпада прецизно с предоставената схема
  • Типовете се спазват (низ, число, булева стойност и др.)
  • Вашият код може да консумира отговора директно

Два налични подхода

Grok API предлага два метода за използване на структурирани изходи:

  • parse(): Автоматичен метод, който връща директно типизиран обект. Идеален за повечето случаи.
  • response_format: Ръчен метод, който връща JSON низ. Осигурява по-голям контрол, но анализирането е Ваша отговорност.

Ще разгледате тези два метода подробно в следващите уроци.

Ключови изводи

  • Структурираните изходи гарантират JSON, съвместим с Вашата схема при всяко извикване
  • Ограничението се прилага по време на генерирането, а не след това
  • Всички езикови модели на xAI поддържат тази функция
  • Налични са два метода: parse() (автоматичен) и response_format (ръчен)
  • Това е основата на всеки надежден производствен конвейер с Grok API