JSON с гаранция за съответствие със схема
На тази страница
Защо структурираните изходи променят всичко
Когато използвате езиков модел в производствена среда, Ви трябват отговори, които кодът може да използва директно. Не свободен текст, не приблизителен 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 и по-нови версии. Независимо кой модел използвате, функцията е достъпна без допълнителни разходи или конфигурация.
Без срещу със структурирани изходи
Ето какво получавате без и с тази функция:
Без структурирани изходи:
- Моделът може да върне свободен текст, частичен JSON или неочакван формат
- Трябва да извършвате ръчно анализиране и да обработвате грешки
- Имената на полетата могат да варират от една заявка до друга
- Вашият конвейер се срива веднага щом моделът промени формата
Със структурирани изходи:
- JSON винаги е синтактично валиден
- Структурата съвпада прецизно с предоставената схема
- Типовете се спазват (низ, число, булева стойност и др.)
- Вашият код може да консумира отговора директно
Два налични подхода
Grok API предлага два метода за използване на структурирани изходи:
parse(): Автоматичен метод, който връща директно типизиран обект. Идеален за повечето случаи.response_format: Ръчен метод, който връща JSON низ. Осигурява по-голям контрол, но анализирането е Ваша отговорност.
Ще разгледате тези два метода подробно в следващите уроци.
Ключови изводи
- Структурираните изходи гарантират JSON, съвместим с Вашата схема при всяко извикване
- Ограничението се прилага по време на генерирането, а не след това
- Всички езикови модели на xAI поддържат тази функция
- Налични са два метода:
parse()(автоматичен) иresponse_format(ръчен) - Това е основата на всеки надежден производствен конвейер с Grok API