Перейти к содержимому
TokIQ

Структурированный вывод

Структурированный вывод: как получить JSON, который можно разобрать

Промптинг структурированного вывода — это способ добиться от модели ответа в фиксированной, машиночитаемой форме, обычно в виде JSON по схеме. Надёжный подход сочетает чёткую схему, пример, режим структурированного вывода или JSON-режим провайдера (если он есть) и проверку в вашем коде с повторной попыткой при ошибке разбора.

Скоро вApp StoreДоступно вGoogle Play

Пример вопроса · Структурированный вывод

Ваше приложение разбирает JSON от модели, но иногда ответ начинается со слов «Конечно! Вот JSON:». Какое исправление самое надёжное?

  1. AДобавить в промпт «пожалуйста»
  2. BИспользовать режим структурированного вывода / JSON-режим API со схемой и проверять результат
  3. CСнизить температуру до 0 и надеяться
  4. DОтрезать первую строку каждого ответа
Показать ответ и объяснение

B. Использовать режим структурированного вывода / JSON-режим API со схемой и проверять результат Встроенные режимы структурированного вывода ограничивают ответ корректным JSON, а проверка по схеме ловит остальное. Хитрости со строками ломаются, как только меняется формулировка.

Что проверяют вопросы

  • Как описать схему, которой модель может следовать
  • Обязательные поля, перечисления и пустые значения
  • Проверка вывода и повтор при сбое
  • Как не пускать прозу в машиночитаемые ответы

Чему вы научитесь

  • Как задавать JSON-вывод со схемой
  • Как обрабатывать отсутствующие или неизвестные значения
  • Когда использовать встроенные функции структурированного вывода
  • Как проверять и восстанавливать неудачный вывод

Как тренироваться в TokIQ

  1. 1. Откройте «Структурированный вывод». Выберите тему в списке на вкладке Quiz. Это тема Premium; бесплатный тариф включает «Основы», «Роль и контекст» и «Примеры».
  2. 2. Отвечайте на один вопрос за раз. Вы сразу видите, верно ли ответили.
  3. 3. Нажмите Why? Прочитайте короткое объяснение и ответьте на три дополнительных вопроса по той же идее.
  4. 4. Следите за точностью. Вкладка Progress показывает, как «Структурированный вывод» выглядит на фоне других ваших тем.

Структурированный вывод: частые вопросы

Как заставить LLM вернуть корректный JSON?

Дайте схему и пример, используйте режим структурированного вывода или JSON-режим провайдера, если он есть, и проверяйте ответ в коде. При сбое повторите запрос, добавив ошибку проверки.

Что модель должна делать, если значение поля неизвестно?

Скажите ей об этом прямо, например: «используй null, если в документе этого нет». Иначе модели склонны заполнять пробелы правдоподобными догадками.

Что почитать дальше

Агенты5 мин чтения

Tool calling в LLM: вызов функций и ИИ-агенты

Как работает tool calling в LLM, как писать описания инструментов, как запускается и останавливается цикл агента и каких сбоев ждать.

Техники5 мин чтения

Few-shot промптинг: примеры против zero-shot

Zero-shot промпт содержит только инструкции, few-shot добавляет примеры. Когда примеры улучшают результат, а когда приводят к копированию, смещению и дрейфу.

Другие темы

Тренируйте «Структурированный вывод» по несколько вопросов в день.

Короткие тесты о реальных решениях при составлении промптов, с объяснением к каждому ответу. Начать можно бесплатно на iPhone и Android.

Скоро вApp StoreДоступно вGoogle Play