🤖 Как создавать промпты для AI, которые выдают желаемый результат

Как я научился получать от AI именно то, что нужно, и сократил время на подготовку документации в 5-10 раз.

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

🎯 TL;DR

  • Структурированный подход к созданию промптов
  • Готовые шаблоны для работы с AI
  • Реальные примеры из практики
  • Универсальный фреймворк шаблона для любых задач

😅 В чем была проблема?

Работа с AI похожа на работу с подкованным стажером. Он сделает всё, что вы скажете, но из-за недостатка практического опыта нуждается в детальных инструкциях. Вот реальный пример из моей практики:

🚫 Мой первый промпт

"Напиши требования для сервиса рассылок в Telegram"

Результат:

# Требования к сервису рассылок Telegram ## 1. Функциональные требования ### 1.1 Управление подписчиками - Автоматическая регистрация пользователей при старте бота - Возможность отписаться от рассылки - Хранение информации о подписчиках (Telegram ID, username, дата подписки) - Группировка подписчиков по категориям/тегам - Ведение статистики по подписчикам ### 1.2 Управление контентом - Создание шаблонов сообщений - Поддержка различных типов контента: - Текстовые сообщения с форматированием - Изображения - Видео - Документы - Опросы - Инлайн-кнопки - Возможность отложенной публикации - Предварительный просмотр сообщений - Сохранение черновиков ### 1.3 Управление рассылками - Создание одноразовых и периодических рассылок - Таргетирование по группам пользователей - Установка времени отправки - Настройка частоты отправки для периодических рассылок - Возможность отмены запланированных рассылок - Контроль скорости отправки (защита от спама) ### 1.4 Аналитика - Статистика доставки сообщений - Статистика открытий и кликов - Отчеты по эффективности рассылок - Экспорт данных в CSV/Excel - Визуализация основных метрик ## 2. Нефункциональные требования ### 2.1 Производительность - Поддержка не менее 100,000 подписчиков - Отправка не менее 100 сообщений в секунду - Время ответа API не более 500мс - Время запуска рассылки не более 5 минут ### 2.2 Надежность - Доступность сервиса 99.9% - Автоматическое восстановление после сбоев - Резервное копирование данных - Обработка ошибок API Telegram - Механизм повторных попыток при сбоях ### 2.3 Безопасность - Аутентификация и авторизация администраторов - Ролевая модель доступа - Защита от DDoS атак - Шифрование чувствительных данных - Логирование действий пользователей ### 2.4 Масштабируемость - Горизонтальное масштабирование - Балансировка нагрузки - Кэширование данных - Асинхронная обработка задач - Очереди сообщений ### 2.5 Мониторинг - Мониторинг состояния сервиса - Алерты при критических ошибках - Метрики производительности - Логирование всех операций - Трейсинг запросов ## 3. Технические требования ### 3.1 API - REST API для управления рассылками - Документация в формате OpenAPI/Swagger - Версионирование API - Поддержка rate limiting - Валидация входных данных ### 3.2 Интеграции - Telegram Bot API - Система аналитики - Система мониторинга - Система логирования - Хранилище файлов ### 3.3 Интерфейс администратора - Веб-интерфейс для управления - Адаптивный дизайн - Поддержка основных браузеров - Интуитивно понятный интерфейс - Быстрая загрузка страниц ## 4. Требования к документации ### 4.1 Техническая документация - Архитектура системы - API документация - Инструкции по развертыванию - Описание базы данных - Процедуры резервного копирования ### 4.2 Пользовательская документация - Руководство администратора - Инструкции по созданию рассылок - FAQ - Описание типовых сценариев - Рекомендации по использованию

📊 Что тут не так

К сожалению, результат довольно поверхностный. Тут есть 2 варианта: детально прогонять каждый компонент через AI и заполнять структуру, либо же подготовить промпт, который сразу выдаст более структурированный результат.

🎯 Как сделать промпты лучше

После нескольких неудачных попыток я понял: нужна четкая структура. Как и в работе с реальным стажером, важно:

  • 📝 Объяснить контекст проекта
  • 🎭 Определить роль и ответственность
  • 🎯 Установить четкие критерии успеха
  • ⚠ Обозначить технические ограничения

Вот пример промпта, который позволяет получить более структурированный результат:

# Контекст и роль эксперта <expert_profile> - Специализация: Product Management для коммуникационных сервисов - Опыт: Разработка продуктов для массовых коммуникаций - Ключевые компетенции: - Проектирование пользовательских сценариев - Анализ бизнес-процессов - Управление продуктовыми метриками - Работа с системами массовых рассылок </expert_profile> # Исходные данные <input_data> - Контекст задачи: Создание сервиса рассылок через Telegram для бизнеса - Имеющиеся ресурсы: - Telegram Bot API - Базовая серверная инфраструктура - Команда разработки - Ограничения: - Лимиты Telegram API на отправку сообщений - Необходимость быстрого запуска MVP </input_data> # Цели и критерии успеха <objectives> 1. Основная цель: Создание понятной доменной модели сервиса рассылок 2. Измеримые метрики: - Покрытие всех основных бизнес-сценариев - Понятность модели для всех стейкхолдеров - Возможность быстрой имплементации MVP 3. Ожидаемые результаты: - Визуальная схема доменной модели в формате mermaid - Описание основных сущностей и их взаимосвязей - Список ключевых бизнес-правил </objectives> # Методология решения <methodology> 1. Анализ предметной области: - Определение ключевых сущностей - Выявление основных процессов - Идентификация бизнес-правил - Определение точек интеграции 2. Требования к визуализации: - Использовать нотацию mermaid - Показать основные сущности и связи - Выделить агрегаты и их границы - Отобразить потоки данных 3. Формат описания сущностей: - Название и назначение - Основные атрибуты - Связи с другими сущностями - Бизнес-правила и ограничения </methodology> # Формат вывода <output> 1. Доменная модель в формате mermaid: - Диаграмма классов для основных сущностей - Диаграмма процессов для основных сценариев - Визуализация агрегатов 2. Текстовое описание: - Описание каждой сущности - Основные бизнес-правила - Ключевые сценарии использования 3. Метрики и ограничения: - Бизнес-ограничения - Технические ограничения - Метрики успеха </output>

📈 Что изменилось?

С новым подходом AI сгенерировал детальную документацию, которая включала:

🤖 Как создавать промпты для AI, которые выдают желаемый результат
classDiagram class Organization { +UUID id +String name +String telegramToken +List~Contact~ contacts +createCampaign() +addContact() } class Campaign { +UUID id +String name +DateTime scheduleTime +MessageTemplate template +TargetAudience audience +CampaignStatus status +start() +pause() +resume() } class MessageTemplate { +UUID id +String content +List~Button~ buttons +MediaContent media +validate() } class Contact { +UUID id +String telegramId +SubscriptionStatus status +Map~String,String~ attributes +updateAttributes() +unsubscribe() } class TargetAudience { +UUID id +List~FilterRule~ rules +evaluate(Contact) } class DeliveryStats { +UUID campaignId +int sent +int delivered +int failed +int opened +update() } Organization "1" -- "*" Campaign Organization "1" -- "*" Contact Campaign "1" -- "1" MessageTemplate Campaign "1" -- "1" TargetAudience Campaign "1" -- "1" DeliveryStats
Ключевые сущности и правила: 1. Organization - Владеет контактами и кампаниями - Хранит токен для интеграции с Telegram - Правила: уникальный токен, валидация через Telegram API 2. Campaign - Управляет процессом рассылки - Статусы: DRAFT, SCHEDULED, ACTIVE, PAUSED, COMPLETED - Правила: проверка лимитов API, валидация расписания 3. MessageTemplate - Шаблон сообщения с поддержкой медиа и кнопок - Правила: валидация размера контента, проверка форматирования 4. Contact - Подписчик с атрибутами для таргетинга - Статусы: ACTIVE, UNSUBSCRIBED, BLOCKED - Правила: уникальный Telegram ID, согласие на рассылки 5. TargetAudience - Правила фильтрации получателей - Правила: валидация условий, проверка атрибутов 6. DeliveryStats - Метрики доставки и открытия - Правила: атомарное обновление счетчиков Технические ограничения: - Лимиты Telegram API: 50 сообщений/сек - Максимальный размер сообщения: 4096 символов - Ограничения на медиа-контент Метрики успеха: - Процент успешных доставок >95% - Время обработки кампании - Точность таргетинга

💡 Важно понимать, что на выходе конкретные сущности и бизнес правила могут отличаться. Поэтому нужен оператор в виде специалиста, который может результат провалидировать и дать фидбек, что нужно поправить. Также везде, где есть числа — нужно понимать, что они в ответе написаны "от балды". Но то, что они там есть — это уже хорошо. Их можно выделить в технические параметры, которые будут привязаны к определенным продуктовым метрикам.

🛠 Как внедрить этот подход

1. 🌱 Начните с простых задач

  • Возьмите небольшую часть проекта
  • Примените структурированный промпт
  • Сравните результат с тем, что написали бы сами

2. 📚 Создайте свою библиотеку промптов

  • Сохраняйте успешные формулировки
  • Документируйте, что сработало, а что нет
  • Регулярно обновляйте шаблоны

3. 📊 Учитесь на ошибках

  • Записывайте неудачные попытки
  • Анализируйте, где инструкции были неясными
  • Улучшайте формулировки

💡 Что дальше?

Помните: AI — это не замена разработчику, а мощный инструмент, который становится эффективнее с правильным подходом. Как и с реальным стажером, чем лучше вы объясните задачу, тем качественнее будет результат.

📝 Бонус: Универсальный шаблон промпта

# Контекст и роль эксперта <expert_profile> - Специализация: [указать основную область экспертизы] - Опыт: [указать релевантный опыт] - Ключевые компетенции: [перечислить 3-5 ключевых навыков] </expert_profile> # Исходные данные <input_data> - Контекст задачи: [описание ситуации] - Имеющиеся ресурсы: [доступные инструменты/данные] - Ограничения: [технические/бизнес ограничения] </input_data> # Цели и критерии успеха <objectives> 1. Основная цель: [четкое описание желаемого результата] 2. Измеримые метрики: - [метрика 1]: [целевое значение] - [метрика 2]: [целевое значение] 3. Ограничения по срокам: [временные рамки] </objectives> # Методология решения <methodology> 1. Анализ ситуации: ``` Для каждого аспекта: - Факты: [наблюдаемые данные] - Гипотезы: [предположения] - Риски: [возможные проблемы] - Уверенность: [1-5] ``` 2. Разработка решения: - Альтернативы: [минимум 3 варианта] - Критерии выбора: [список критериев] - Обоснование: [логика выбора] 3. План реализации: - Этапы: [последовательность действий] - Контрольные точки: [измеримые результаты] - Необходимые ресурсы: [что требуется] </methodology> # Валидация результатов <validation> 1. Проверка соответствия целям: - [цель 1]: [степень достижения] - [цель 2]: [степень достижения] 2. Оценка рисков: - [риск 1]: [вероятность/влияние] - [риск 2]: [вероятность/влияние] 3. Обратная связь: - От кого: [источники feedback] - Критерии: [что проверяем] - Метод сбора: [как получаем] </validation> # Формат вывода <output> 1. Краткое резюме (executive summary): - Ключевые выводы - Рекомендации - Следующие шаги 2. Детальный анализ: - Методология - Обоснование - Ограничения 3. План действий: - Конкретные шаги - Сроки - Ответственные </output>

⭐ P.S. Личный лайфхак

Я храню свои промпты в markdown файлах, а также веду базу знаний с практиками и процессами. Это помогает индексировать все файлы и генерировать промпты на основе контекста проекта. Об этом подробнее расскажу в последующих статьях.

Подписывайтесь на мой Telegram канал, там я пишу про свой опыт запуска продуктов с нуля, а также внедрения AI в бизнес.

Желаю всем продуктивной работы!

3
8
2 комментария

Главное чётко написать запрос, дальше всё сделает ИИ

Круто, спасибо за статью!