JSON Schema — это способ формально описать, каким должен быть JSON-объект. В схеме указывают поля, типы данных, обязательные свойства, допустимые значения, вложенные объекты, массивы и ограничения.
Проще говоря, JSON Schema — это “контракт” между системой и данными. Если AI-модель должна вернуть не произвольный текст, а понятный объект для программы, схема задает формат: например, `name` должен быть строкой, `price` — числом, `status` — одним из разрешенных вариантов, а `items` — массивом объектов.
В AI-приложениях JSON Schema особенно полезна для structured output, tool calling и автоматизации. Она помогает получать от модели данные, которые можно сразу передать в CRM, таблицу, API, базу данных или внутренний workflow. Без схемы модель может вернуть красивый текст, но программа не поймет, куда его положить.
JSON Schema не гарантирует смысловую правильность ответа, но сильно снижает хаос на уровне формата. Она отвечает за структуру: есть ли нужные поля, правильные ли типы, нет ли лишних значений. А качество содержания нужно проверять отдельно: через валидацию, бизнес-правила, источники, evals и ручной контроль в важных сценариях.
Примеры
- AI-агент извлекает из счета номер, дату, сумму и ИНН строго по JSON Schema.
- Tool calling использует схему, чтобы модель передала функции `city`, `date` и `limit` в правильных типах.
- Structured output возвращает статус заявки только из списка: `new`, `in_progress`, `done`, `rejected`.
- Система проверяет ответ модели: если поле `email` отсутствует, результат не отправляют в CRM.
- Для классификации письма схема задает поля `category`, `priority`, `summary` и `next_action`.
Где используется
- Structured output в AI-приложениях
- Описание параметров tool calling и function calling
- Извлечение данных из документов, писем, счетов и договоров
- Проверка ответа модели перед записью в CRM, таблицу или API
- Классификация обращений, лидов, отзывов и задач
- Стабильный обмен данными между AI-агентом и backend-системой
- Снижение ошибок формата в no-code и low-code автоматизациях
Связанные термины
Частые вопросы
Зачем JSON Schema нужна AI-агенту?
Она задает ожидаемый формат ответа. Агент может не просто написать текст, а вернуть структурированные данные: поля, типы, списки, статусы и вложенные объекты, которые дальше использует программа.
JSON Schema гарантирует правильный ответ модели?
Нет. Она проверяет структуру и типы, но не доказывает, что смысл ответа верный. Например, схема может проверить, что сумма — число, но не знает, правильно ли модель прочитала сумму из документа.
Чем JSON Schema отличается от обычного примера JSON?
Пример показывает один возможный объект, а схема описывает правила для всех допустимых объектов: обязательные поля, типы, enum, массивы, ограничения и вложенность.
Какие ошибки чаще всего бывают в схемах?
Слишком сложная вложенность, неясные названия полей, отсутствие `required`, слишком свободные строки вместо enum, противоречивые типы и попытка описать бизнес-логику только схемой.
