Як написати промпт для ШІ-агента з першого разу

Що таке промпт простими словами

Дзвониш курʼєрові й кажеш одне слово: «їжу». Що він привезе? Та що завгодно. Може, борщ. Може, суші. Може, корм для кота. І не причепишся - ти ж сам сказав «їжу». Курʼєр не телепат.

З ШІ-агентом - один в один. Він не вгадує, чого ти хочеш. Він робить те, що ти написав. Сформулював розпливчасто - агент сам заповнить прогалини. На свій смак. А смак у нього свій, і збігається з твоїм він рідко.

Чому промпт - головна навичка вайбкодера

Ти вайбкодер. Код руками ти не пишеш - ти ставиш задачі словами. Отже, промпт - твій головний інструмент. По суті, єдиний. Криво сформулював - криво отримав. Як з гітарою: інструмент один і той самий, а звук залежить від того, хто за нього взявся.

Що тобі дає чіткий промпт:

• результат з першого-другого разу, а не на десятому колі правок;
• менше змарнованих токенів Токен - шматочок тексту, яким ШІ читає й пише. За кожне коло переписок ти платиш токенами - тобто грошима й часом. - кожне «ні, не так, переробляй» коштує грошей і нервів;
• агент не ламає те, що ти не просив чіпати;
• ти перестаєш злитися на ШІ. І починаєш бачити: справа ж була в запиті.

Різниця між «ШІ написав якусь дичину» і «ШІ написав рівно те, що треба» - це майже завжди один абзац тексту, який ти йому згодував. Розберемо, з чого цей абзац збирається.

Чотири питання хорошого промпту: ЩО, ДЕ, ГОТОВО, НЕ МОЖНА

Будь-який робочий промпт подумки відповідає агентові на чотири питання. Не відповіси ти - відповість він. За тебе й на свій лад. Запамʼятай їх короткою формулою: «ЩО - ДЕ - ГОТОВО - НЕ МОЖНА».

ЩО зробити: формулюємо задачу конкретно

Здавалося б, найочевидніше. І все одно тут помиляються найчастіше. «Зроби кнопку» - це не задача. Кнопку чого? Де? Яку? Чим конкретніше дієслово й обʼєкт, тим менше місця для фантазії в агента.

• Погано: «покращ сайт»
• Добре: «додай на головну сторінку кнопку «Записатися»; після кліку відкривається форма з полями імʼя й телефон»

ДЕ зробити: вкажи файл, сторінку, контекст

Агент не знає твій проєкт так, як знаєш його ти. Скажи, в якому файлі, на якій сторінці, поряд з чим. Інакше він або почне шукати навмання, або наліпить щось нове замість того, щоб поправити наявне.

ГОТОВО: опиши критерій приймання результату

Це критерій приймання Критерій приймання - простий опис того, як ти зрозумієш, що задачу зроблено правильно. Наприклад: «кнопка синя, після кліку відкривається форма, на телефоні нічого не зʼїжджає». . Опиши результат очима звичайної людини: що я маю побачити на екрані, щоб сказати «так, готово». Немає критерію - агент сам вирішить, що вважати готовим. І його планка навряд чи збіжиться з твоєю.

НЕ МОЖНА: задай межі, чого НЕ чіпати

Найбільш недооцінений пункт. Агент - старанний відмінник. Дай йому волю - і він «заодно» перепише половину проєкту, «бо так краще». Скажи прямо, чого чіпати не можна: «не змінюй інші сторінки», «не переписуй те, що вже працює», «не додавай нових бібліотек».

Чіткий промпт проти розпливчастого: порівняння

Приклад промпту: було і стало

Пишеш агентові: «зроби нормальну форму зворотного звʼязку». Агент бадьоро ліпить форму з десятьма полями, зі своїм дизайном, лізе в чужі файли, заразом ламає шапку - і гордо рапортує «готово». Ти в жаху.

Де прокол? Ти відповів тільки на питання ЩО - та й то розмито, словом «нормальну». На ДЕ, ГОТОВО, НЕ МОЖНА агент відповів за тебе сам. І схибив у всіх трьох.

А тепер той самий запит, але за схемою «ЩО - ДЕ - ГОТОВО - НЕ МОЖНА»:

Додай форму зворотного звʼязку на сторінку контактів.
ЩО: форма з трьома полями - імʼя, email, повідомлення - і кнопкою «Надіслати».
ДЕ: на сторінці контактів, під текстом з адресою. Знайди потрібний файл сам, а якщо не впевнений - запитай.
ГОТОВО: на екрані видно форму з трьох полів і кнопки. Якщо натиснути «Надіслати» з порожніми полями - зʼявляється підказка «заповни поля». На телефоні форма не зʼїжджає за край.
НЕ МОЖНА: не змінюй інші сторінки, не чіпай шапку й меню, не додавай нові бібліотеки без мого дозволу.

Чек-лист: як перевірити промпт перед відправкою

Є простий прийом. Перед відправкою прочитай промпт очима агента, який про тебе й твій проєкт не знає анічогісінько. Не можеш відповісти на якесь питання прямо з тексту? Це дірка. І агент заткне її сам.

Прожени запит за міні-чек-листом - по суті, рівно це й робить скіл prompt-optimizer: вишукує в запиті відсутній контекст:

1. Зрозуміло, ЩО саме зробити? Конкретний обʼєкт і дія, а не «покращити».
2. Зрозуміло, ДЕ? Файл, сторінка, місце - або хоча б дозвіл пошукати.
3. Зрозуміло, що вважати ГОТОВИМ? Що саме я побачу на екрані.
4. Сказано, чого НЕ МОЖНА? Межі, що не чіпати.
5. Задача не завелика? Якщо в одному промпті «зроби магазин» - ріж на шматки.

Часті помилки в промптах для ШІ

• Слова-гумки. «Красиво», «нормально», «сучасно», «краще» - кожен розуміє по-своєму. Агент теж. Міняй на конкретику.
• Мовчання про місце. Не сказав де - агент гадає або плодить нове замість правок.
• Немає критерію готовності. «Готово» за версією агента і «готово» за твоєю - це два різні «готово».
• Забув про межі. Найболючіша: агент «заодно» переробляє й ламає робоче.
• Гігантська задача одним промптом. «Зроби мені соцмережу» агент проковтне, але вдавиться. Ріж на кроки.
• Відправив, не перечитавши. 30 секунд на вичитку економлять півгодини переробок. Чесна угода.