Перевод с разбором · для Сони

Обзор промпт-инжиниринга

Зачем тебе это нужно

У тебя Telegram-бот для людей с СДВГ на OpenAI API. Внутри бота — промпты: текстовые инструкции, по которым модель ведёт разговор, диагностирует интересы пользователя, помогает составить план. Промпт-инжиниринг — это как раз про то, как формулировать эти инструкции так, чтобы модель вела себя предсказуемо и по делу, а не «как получится».

Эта статья — общая точка входа. Она говорит, с чего начинать и о чём не эта область. Конкретные техники — в следующих статьях роадмэпа.

Прежде чем тюнить промпты

В оригинале у Anthropic три предусловия, и они разумные:

1. Ясные критерии успеха. Что значит «бот хорошо отработал»? Для твоего случая: пользователь ушёл с готовым планом на неделю, или сформулировал один долгосрочный интерес, или почувствовал себя услышанным (понимаю, это субъективно — мы вернёмся к этому в статье про evals, оценку качества).
2. Способ эмпирически проверять результат. Нужен набор «типовых диалогов», на которых ты быстро говоришь: новый промпт лучше или хуже старого. 10–20 тестовых сценариев достаточно для начала.
3. Первый набросок промпта. Не идеальный — достаточно того, что «работает как-то». Потом итерируешь.

Когда промпт-инжиниринг помогает

Он чинит то, что про «как разговаривать»: тон, структура, удержание роли, формат ответа, что спрашивать первым. Не чинит то, что про «сколько платим и как быстро»: эти задачи обычно решаются сменой модели (например, с GPT-5.4 на GPT-5.4 mini — см. гайд про выбор OpenAI-модели).

Как заниматься промпт-инжинирингом

Все базовые техники — ясные инструкции, примеры, XML-теги, назначение роли, пошаговое мышление, цепочки промптов — собраны у Anthropic в одном большом документе «Prompting best practices». В этом справочнике каждая тема вынесена в отдельную статью. В твоём роадмэпе они идут по порядку от самых важных.

Anthropic также предлагает инструменты (генератор промптов, улучшатель промптов) в Claude Console — но это больше для разработчиков Anthropic API. Для работы с OpenAI бери тот же смысл, но руками: в Claude Chat попроси «помоги улучшить этот промпт, вот мой черновик» — и итерируй.

Как учиться

Кроме чтения, есть интерактивный tutorial на GitHub — anthropic/prompt-eng-interactive-tutorial, и более лёгкая версия в Google Sheets. Оба англоязычные, но Claude может переводить на ходу.

Что это значит для твоего бота

• Заведи файл test-dialogs.md с 10 типовыми диалогами «вход пользователя → желаемый ответ». Это твой якорь.
• Держи текущий system prompt бота в отдельном файле (system-prompt.md). Коммить историю правок — будешь видеть, как он эволюционировал.
• Не старайся вылизать промпт с первого раза. Лучше 10 итераций по 10 минут, чем 1 день над «идеальным».
• Если чувствуешь «бот как-то деревянный» — это сигнал, что пора в следующую статью (Чётко и прямо).

Полная версия с деталями API — в docs/overview.html.