Структурированный вывод (JSON): отвечай по форме

🍱 Бланк с полями против свободного письма

В прошлой теме про должностную инструкцию и разделители мы учились объяснять повару, кто он и где границы заказа. Теперь — про то, в каком виде он должен подать готовое блюдо. Это разные вещи: одно дело, что повар приготовил, другое — как он это выложил на выдачу.

Представь два способа подачи. Первый: повар приносит тебе блюдо в руках, всё свалено горкой, «вот, держи, тут лосось, рядом вроде соус, а это гарнир, кажется». Вкусно, наверное. Но если за этой выдачей стоит конвейер — официант, который должен мгновенно понять, что куда, — он встанет в ступор. Где порция? Сколько соуса? Это вообще на какой стол?

Второй способ: повар выкладывает всё в стандартную гастроёмкость с подписанными отсеками — в одном отсеке основное, в другом соус, в третьем гарнир, на крышке номер стола. Любой на раздаче возьмёт и поймёт мгновенно, не переспрашивая. Это и есть структурированный вывод: ответ не «на глаз в руках», а разложенный по заранее оговорённой форме.

Для текста та же история — это разница между свободным письмом и бланком с полями. Свободное письмо человек прочитает легко, а машина — нет. Бланк, где у каждого факта своё подписанное поле, машина прочитает с ходу, а заполнить его модель тоже умеет — если её об этом попросить.

🔤 Что такое JSON и почему все системы говорят на нём

У этого «бланка с полями» есть общепринятый вид, на котором между собой договариваются почти все программы мира. Называется он JSON (структурированный формат данных — читается «джейсон»). Не пугайся слова: по сути это просто способ записать «поле — значение» так, чтобы любая программа поняла одинаково.

Смотри, как он устроен, на нашем примере. Пары «название поля : его значение», каждая на своей строке, всё в фигурных скобках:

Почему именно он, а не просто красивый текст? Потому что у JSON есть жёсткая, всегда одинаковая форма. У поля «имя» всегда будет значение «имя» — не «звать её», не «отправитель», не «клиентка». Поэтому программа, которая принимает такой ответ, заранее знает, где искать каждый кусочек, и берёт его без догадок. Это и есть подписанные отсеки гастроёмкости: повар может приготовить разное, но раскладка всегда одна, и раздача никогда не путается.

Тебе как владельцу не нужно уметь писать JSON руками — это работа поваров. Тебе нужно понимать одну вещь: когда ответ модели должна читать другая программа, проси ответ в этой строгой форме, а не вольным текстом. Дальше код подхватит сам.

📋 Как попросить ответ по форме (тремя движениями)

Хорошая новость: чтобы получить структурированный ответ, не нужно ничего технического. Достаточно в запросе чётко сказать три вещи — вот они на той же задаче с письмами.

Разберём по движениям. Первое — назвать форму: «верни в формате JSON». Этим ты сразу отсекаешь сочинение. Второе — перечислить поля: какие именно отсеки в гастроёмкости и что в каждый класть. Тут же стоит сказать тип — где число, где текст, где выбор из готового списка («доволен / нейтрально / недоволен»). Чем точнее опишешь форму, тем точнее повар её заполнит. Третье — закрыть лазейку для фантазии: «нет данных — поставь „не указано“, не выдумывай». Иначе модель «из вежливости» может дописать правдоподобное, а на самом деле взятое из воздуха.

Заметь, как это перекликается с прошлыми темами модуля: тут работают и точность заказа, и заранее заданные границы. Структурированный вывод — не отдельный фокус, а ещё один способ дать повару ровно тот заказ, какой нужен.

🔌 Зачем это бизнесу: клей между моделью и системами

Вот ради чего всё. Сам по себе красивый ответ модели — это тупик: его прочитал человек, и дальше всё снова руками. А структурированный ответ — это труба, по которой данные сами текут из модели в твои системы: в таблицу, в 1С, в CRM, в следующую программу по цепочке.

Разница прямая и денежная. Со свободным текстом каждый ответ кто-то должен прочитать и перенести руками — это упирается в человеко-часы и в опечатки. С формой ответ занимается своим местом автоматически: пришло письмо → модель разобрала по бланку → программа сама занесла в таблицу и завела заявку. Сто писем за минуту вместо трёх часов руками. И главное — предсказуемо: форма всегда одна, значит, принимающая программа не сломается на пятьдесят третьем ответе из-за того, что модель вдруг написала чуть иначе.

Именно поэтому структурированный вывод называют клеем автоматизации. Без него каждый кусок системы живёт сам по себе, и между ними сидит человек-переноска. С ним куски склеиваются в один процесс, который работает сам. На этом и держится всё, что в курсе пойдёт дальше — про инструменты агента и про сборку нескольких шагов в цепочку.