Спецификация — чтобы ИИ делал то, что вы задумали

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

Допустим, вы напишете агенту: «запусти форму, чтобы она принимала сообщения». Он возьмется за работу и сделает — но как именно? Любую задачу можно реализовать десятком разных способов. Пользователь отправил форму с пустым именем — принять ее или попросить заполнить? Ввел в email что-то несуразное вроде «abc@» — показать ошибку или принимать как есть? Нажал «отправить» десять раз подряд — считать это спамом или сохранять все десять сообщений? Вдобавок остаются вопросы попроще: какой максимальный размер у сообщения, куда его сохранять, что показать после отправки. Агент не знает ответов на эти вопросы и будет решать все сам на ходу. Результат может оказаться рабочим, но совсем не тем, что вы имели в виду.

Короткая задача описывает, что сделать, но не объясняет, как именно это должно работать. Чтобы агент сделал так, как вы задумали, нужно заранее договориться с ним о деталях. Для этого и нужна спецификация, о которой мы поговорим в этом уроке.

Что такое спецификация

Прежде чем добавлять новую функцию, ее нужно описать в отдельном документе. Что именно она должна делать, как должна работать, как вести себя в нестандартных ситуациях. Этот документ называется спецификация, или просто спек. По сути это техзадание на конкретную работу. Чтобы его написать, не нужно разбираться в коде или технологиях — достаточно на уровне понятий договориться с агентом, как все будет работать.