Расшифровка мастер-класса

Я — Катя

  • 7 лет в документировании

  • CPO Gramax

Почему мастер-класс про ИИ

  • Исследуем

  • Автоматизируем

  • Отдаем в Open Source

Что поделаем:

  • Придумаем кейсы, в которых ИИ полезен

  • Разберемся, из каких частей состоит промпт

  • Выберем по кейсу и напишем к нему промпт

  • Обсудим ограничения и ситуации, где ИИ наколбасит ошибок

Что мы НЕ будем делать:

  • Разбираться, как устроен ИИ

  • Обсуждать, как автоматизировать процессы

Подумай, что болит

  • Что меня бесит?

  • Что отнимает СЛИШКОМ много времени?

  • Когда приходится себя заставлять?

  • Где чаще всего ошибаюсь?

Представь, что делегируешь это

В каких кейсах полезен ИИ

Генерация контента

  • Напиши пост для Instagram…

  • Создай черновик описания функции...

Проверка

  • Проверь текст на ошибки...

  • Убедись, что текст модалки соответствует...

  • Скажи, как сделать текст более читаемым…

Поиск и фактчекинг

  • Найди исследования на эту тему и подтверди мои тезисы…

  • Придумай примеры использования для функций…

  • Убедись, что я указала все возможности в баттл-карте…

  • Найди, в какой книге писалось, что это лучший способ…

Структурирование

  • Переработай эту переписку в полноценную статью…

  • Обработай мою огромную статью и преврати в пост…

Улучшение и дополнение

  • Вот мой текст, вот к нему правки. Внеси…

  • В этой инструкции (ссылка) нужно учесть новые фичи…

Перевод и локализация

  • Переведи инструкцию на английский…

  • Локализуй пост для Испании с учетом культуры…

Брейншторм

  • У меня есть задача замотивировать пользователей…

  • Как улучшить документацию, чтобы у поддержки больше не спрашивали…

Соотнесем кейсы с болями

  • Генерация контента

  • Проверка

  • Поиск и фактчекинг

  • Структурирование

  • Улучшение и дополнение

  • Перевод и локализация

  • Брейншторм

Ура, практика

Я вам запрещаю использовать любые способы обхода блокировок!!!! 😈

Открываем: https://chat.deepseek.com/

Из чего состоит промпт

  • Контекст

    • Роль

    • Аудитория

    • Бренд (компания, услуга, продукт)

  • Задача

  • Стиль и тон

  • Примеры

  • Уточнения

Контекст

  • Роль

  • Аудитория

  • Бренд (компания, услуга, продукт)

Контекст/Роль

  1. Ты — технический писатель, создающий документацию для разработчиков…

  2. Ты — копирайтер, работающий над рекламной кампанией для стартапа…

  3. Ты — SMM-менеджер, управляющий контентом для Instagram-аккаунта бренда…

Контекст/Аудитория

  1. Целевая аудитория — разработчики 25–35 лет с опытом работы с REST API, ожидающие четких инструкций без воды и пространственных рассуждений…

  2. Целевая аудитория — предприниматели 30–45 лет, которые ищут простые решения для автоматизации бизнеса…

  3. Целевая аудитория — молодежь 18–24 лет, интересующаяся экологичной модой и активная в соцсетях…

Контекст/Бренд

  1. Продукт — облачный сервис для управления проектами с функцией интеграции с Trello и Slack…

  2. Услуга — онлайн-курс по UX-дизайну для начинающих дизайнеров, длительностью 6 недель…

  3. Бренд — экологичная одежда из переработанных материалов, ориентированная на молодежь…

Задача

  1. Напиши рекламный текст для email-рассылки, который мотивирует подписчиков зарегистрироваться на вебинар по UX-дизайну…

  2. Создай пошаговую инструкцию для настройки уведомлений в мобильном приложении, чтобы она была понятна новичкам…

  3. Вычитай документ: найди все орфографические и пунктуационные ошибки. Укажи сложные для восприятия места. Проанализируй структуру и предложи, как ее улучшить…

Стиль и тон

  1. Используй вдохновляющий и энергичный тон, как будто ты мотивируешь команду стартапа…

  2. Пиши в формальном стиле, как в официальной документации для корпоративных клиентов…

  3. Текст должен быть дружелюбным и неформальным, добавь немного эмодзи…

Примеры

  • Идеальными инструкциями мы считаем инструкции вот этого продукта: ссылка, ссылка...

  • Оформи статью в соответствии с нашим стандартом. Учти разметку, Tone of Voice и структуру: <текст>…

Уточнения

  • Для всех исследований прикрепи ссылки на источник, приведи точную цитату...

  • Представь результат в виде HTML…

  • Формат результата:

    • Замечания, рассуждения, предложения и вопросы.

    • Переписанная статья с внесением всех исправлений.

Пишем в положительном ключе:

  • Текст не более 100 слов → Текст из 80-95 слов

  • Не используй информацию из интернета → Используй только предоставленную информацию

Сам текст (если есть)

  • Вот текст:

  • Вот файл с текстом

Отправляем, оцениваем

  • Сразу в прод

  • Надо улучшать

  • Руки опускаются, лучше сделаю сам

Что дальше?

  • Корректируем промпт

  • Снова смотрим результат

Относитесь к LLM, как к коллегам: они могут ошибаться и упускать детали.

Но они стараются!

Рекомендации

  1. Описывайте все детали, которыми обладаете. Четче ТЗ — четче ответ.

  2. В сложных задачах делайте несколько итераций.

  3. Пробуйте хаки:

    • Если первый ответ совсем мимо: «задай мне уточняющие вопросы, чтобы лучше справиться с задачей».

    • Если никак не получается синхронизироваться: «опиши, как ты понял задачу и почему именно такой результат мне отправляешь».

  4. Не верьте референсам: ручной фактчекинг важен.

  5. Не давайте на проверку/переписывание огромные документы.

  6. Используйте разные модели.