Промпт для ИИ-агента: из каких блоков состоит рабочая инструкция
13 мин чтения11 пунктов чек-листа + 4 шага плана — готовая основа задачи разработчику.
Кому полезноСпециалисты, которые собирают агента сами или принимают работу подрядчика и хотят понимать, почему агент ведёт себя так, а не иначе.
Что станет понятноПромпт агента — документ из восьми блоков: роль, цель, контекст, порядок действий, инструменты, запреты, формат результата и поведение в спорных случаях
С чем уйдёте11 пунктов чек-листа + 4 шага плана — готовая основа задачи разработчику.
Инструкция для агента — это не одна удачная фраза, а рабочий документ на страницу-две. Разбираем, из каких блоков она складывается, в каком порядке их писать и как понять, что правка сделала агента лучше, а не просто другим.
- Промпт агента — документ из восьми блоков: роль, цель, контекст, порядок действий, инструменты, запреты, формат результата и поведение в спорных случаях.
- Запреты и поведение при нехватке данных важнее описания роли: именно они отличают аккуратного агента от выдумывающего.
- Инструменты описывают так же подробно, как задачу: когда вызывать, что передавать, что делать при ошибке.
- Каждую правку промпта проверяют на всём наборе эталонных примеров, а не на одном случае, который её вызвал.
- Длинный промпт не хуже короткого, если он структурирован; плохо, когда в нём есть противоречия.
- Чем промпт агента отличается от вопроса в чате
- Восемь блоков рабочей инструкции
- Как описать инструменты
- Запреты и поведение при нехватке данных
- Каркас инструкции, который можно взять за основу
- Как проверять правки промпта
- Частые ошибки в промптах агентов
- Путь клиента
- Стратегия по шагам
- Чек-лист
- Что в итоге
- Вопросы и ответы
Чем промпт агента отличается от вопроса в чате
Вопрос в чате пишут для одного ответа. Если результат не понравился, его переспрашивают — человек сам корректирует курс.
Промпт агента пишут для сотен и тысяч запусков, которые никто не видит в момент работы. Переспросить некому. Поэтому инструкция должна заранее отвечать на вопросы, которые в чате решались бы уточнением: что делать, если данных не хватает, если запрос двусмысленный, если инструмент вернул ошибку.
Второе отличие — агент действует. Он не только пишет текст, но и вызывает инструменты: ищет в документах, записывает в таблицу, готовит черновик для отправки. Значит, в промпте должны быть описаны не только слова, но и действия, и их границы.
Третье — промпт живёт долго. Его правят месяцами, и через полгода никто не помнит, зачем добавлена та или иная строка. Поэтому писать его стоит как документ: с разделами и понятной логикой, а не как поток пожеланий.
Восемь блоков рабочей инструкции
1. Роль. Кто агент и для кого работает. Одно-два предложения, без украшений: «Ты готовишь черновики ответов на входящие запросы цены для отдела продаж».
Для сравнения условий полезен материал Проверка фактов за нейросетью: где она ошибается и как это ловить.
2. Цель. Какой результат считается успехом. «Менеджер может отправить черновик с минимальной правкой».
3. Контекст. Что агенту нужно знать о компании и задаче: ассортимент, условия, тон общения, типичные клиенты.
4. Порядок действий. Шаги по номерам: прочитать запрос, определить позицию, найти цену, сверить наличие, составить черновик.
5. Инструменты. Какие есть, когда какой вызывать, что передавать.
6. Запреты. Чего делать нельзя: называть цену, которой нет в прайсе, обещать сроки, отправлять без проверки.
7. Формат результата. Точная структура ответа: поля, порядок, длина. Если результат читает программа, а не человек, — строгий формат с примером.
8. Спорные случаи. Что делать при нехватке данных, двусмысленности, нестандартной просьбе, ошибке инструмента.
Как описать инструменты
Агент выбирает инструмент по его описанию. Если описание расплывчатое, он будет вызывать не то, не вовремя или не вызывать вовсе.
Для каждого инструмента в инструкции стоит указать четыре вещи.
Назначение. Что делает инструмент одной фразой: «Ищет позицию в прайсе по названию или артикулу».
Когда вызывать. «Всегда, когда в запросе упомянут товар. Не пытайся назвать цену по памяти».
Что передавать. Какие параметры и в каком виде: «Название без лишних слов, артикул — если есть».
Что делать с результатом и с ошибкой. «Если позиция не найдена, не подбирай похожую сам — отметь в черновике, что нужна проверка менеджера».
Отдельно полезно указать порядок: какой инструмент вызывается первым и можно ли пропускать шаги. Агенты склонны экономить обращения к инструментам и отвечать по памяти — прямое указание это исправляет.
Спрос вокруг темы статьи
Так читатели формулируют вопрос в поиске.
Запреты и поведение при нехватке данных
Это самый важный блок и самый часто пропускаемый. Модели по умолчанию стремятся дать ответ, даже когда ответа нет. В чате это раздражает, в работе агента — создаёт реальные проблемы: выдуманная цена, несуществующий срок, неверное условие.
Если хочется сравнить этот сценарий с соседним, загляните в Как сгенерировать описания для 500 карточек товара и не получить штампы.
Запреты пишут конкретно, без общих слов. Плохо: «Будь аккуратен с цифрами». Хорошо: «Называй только цены, которые вернул инструмент поиска по прайсу. Если инструмент ничего не вернул — цену не называй».
Для нехватки данных нужен явный выход: «Если в запросе не хватает размеров или количества — не угадывай, а сформулируй уточняющие вопросы в поле „вопросы клиенту“». Когда такого выхода нет, агент заполняет пробел сам.
Полезно предусмотреть передачу человеку: перечислить ситуации, в которых агент не готовит ответ, а помечает задачу для сотрудника. Например, жалоба, просьба о скидке, упоминание срочной поломки.
Каркас инструкции, который можно взять за основу
Ниже — обезличенный каркас. Его стоит заполнить своими данными, а затем проверить на реальных примерах.
Роль: ты помощник отдела продаж, готовишь черновики ответов на запросы цены.
Цель: черновик, который менеджер отправит после быстрой проверки.
Контекст: ассортимент такой-то, работаем в таких-то регионах, общаемся на «вы», коротко и по делу.
Порядок: 1) определи товар и параметры; 2) найди позицию инструментом поиска; 3) проверь наличие; 4) составь черновик; 5) выпиши вопросы, если параметров не хватает.
Запреты: не называй цены не из прайса; не обещай сроки; не предлагай скидки; не отправляй сам.
Формат: поле «черновик», поле «вопросы клиенту», поле «нужна проверка» с причиной.
Спорные случаи: жалоба, просьба о скидке, нестандартный заказ — черновик не готовить, поставить отметку для менеджера.
Каждая строка здесь — ответ на ошибку, которую агент без неё сделает.
Как проверять правки промпта
Типичный сценарий: агент ошибся на одном запросе, в инструкцию добавили строку, этот запрос стал обрабатываться правильно. Но на десяти других, которые раньше шли хорошо, поведение изменилось — и никто этого не заметил.
Защита от этого — набор эталонных примеров. Это пятьдесят-сто реальных случаев с записанными правильными результатами, включая неудобные. После каждой правки промпта прогоняют весь набор и сравнивают три цифры: долю верных ответов, долю ответов с правкой и долю опасных ошибок.
Правка принимается, только если опасных ошибок не стало больше, а верных — меньше. Иначе её откатывают или переписывают.
Версии промпта стоит хранить с датой и короткой пометкой, что изменено и почему. Через пару месяцев только так можно понять, откуда взялась странная строка и можно ли её убрать.
Частые ошибки в промптах агентов
Противоречия. В одном месте «отвечай кратко», в другом «объясняй подробно». Агент выбирает случайно, поведение плавает.
Общие слова вместо правил. «Будь вежлив», «будь точен» не меняют поведение. Работают конкретные указания с примерами.
Нет выхода при нехватке данных. Агент заполняет пробел сам — отсюда выдуманные цифры.
Формат описан словами без примера. Если результат читает программа, один пример правильного вывода полезнее абзаца описания.
Всё в одном агенте. Инструкция разрастается до десяти задач, и агент начинает путать их. Сигнал разделить работу на несколько агентов с короткими инструкциями.
Правка без проверки. Строку добавили под один случай и не прогнали остальные.
Путь клиента: где эта тема срабатывает
Специалист собрал агента, но тот ведёт себя непредсказуемо, и нужно понять, как навести порядок в инструкции.
Что у клиентаАгент выдумывает и путает задачи.
Что делаемПоказать, что причина чаще в инструкции, а не в модели.
Сигнал, что работаетПереходы по запросам о промптах для агентов.
Что у клиентаНе знает, из чего она должна состоять.
Что делаемДать восемь блоков и каркас.
Сигнал, что работаетДочитывания до каркаса инструкции.
Что у клиентаНе описал запреты и нехватку данных.
Что делаемОбъяснить явный выход и передачу человеку.
Сигнал, что работаетСнижение выдуманных ответов.
Что у клиентаЧинит один случай, ломает другие.
Что делаемВвести эталонный набор и версии.
Сигнал, что работаетПравки принимаются по цифрам.
Стратегия: что делать по шагам
Цель: Получить инструкцию агента, которая даёт предсказуемый результат и безопасно правится.
- Шаг 1 Разложить текущий промпт по восьми блокам Видно, каких блоков не хватает.
- Шаг 2 Дописать запреты и выход при нехватке данных Агент перестаёт заполнять пробелы сам.
- Шаг 3 Описать инструменты по четырём пунктам Агент вызывает нужный инструмент вовремя.
- Шаг 4 Проверять каждую правку на эталонном наборе Улучшения не ломают то, что работало.
Сроки — ориентир для планирования, а не обязательство: скорость зависит от ниши, конкуренции и состояния сайта.
Проверка инструкции агента
- Роль описана одной-двумя фразами
- Цель сформулирована как проверяемый результат
- Порядок действий разбит на шаги по номерам
- Для каждого инструмента указано, когда его вызывать
- Описано, что делать при ошибке инструмента
- Запреты сформулированы конкретно, без общих слов
- Есть явный выход при нехватке данных
- Перечислены случаи передачи задачи человеку
- Формат результата показан на примере
- В инструкции нет противоречащих друг другу правил
- Версии промпта хранятся с датой и причиной правки
Что в итоге
Хороший промпт агента похож на должностную инструкцию нового сотрудника: кто ты, что делаешь, по какому порядку, чем пользуешься, чего нельзя и к кому идти, если непонятно. Большая часть ошибок агентов лечится именно здесь, без смены модели.
Начните с двух блоков, которых чаще всего нет: запретов и поведения при нехватке данных. А любые правки после этого принимайте только по итогам прогона на эталонных примерах.
Вопросы и ответы
Какой длины должен быть промпт для ИИ-агента?
Такой, чтобы закрыть восемь блоков: роль, цель, контекст, порядок, инструменты, запреты, формат и спорные случаи. Обычно это страница-две. Длина сама по себе не мешает, мешают противоречия и повторы, поэтому инструкцию пишут с разделами.
Что такое системный промпт?
Это постоянная инструкция, которая задаёт поведение агента во всех запусках: роль, правила, запреты, формат. Она отличается от конкретного запроса, который меняется от случая к случаю. Именно системный промпт определяет, как агент поведёт себя в ситуации, о которой его никто не спрашивал.
Можно ли взять готовый промпт из интернета?
Как каркас — да, как готовое решение — нет. Чужой промпт не знает ваших данных, запретов и спорных случаев. Его структуру полезно заимствовать, но содержимое каждого блока придётся написать под свою задачу и проверить на своих примерах.
Почему агент игнорирует часть инструкции?
Частые причины: противоречие с другой строкой, слишком общее формулирование, отсутствие примера или перегруженность промпта десятком задач. Помогает переписать правило конкретно, добавить пример правильного поведения и, если задач много, разделить их между несколькими агентами.
Как понять, что новая версия промпта лучше?
Прогнать обе версии на одном наборе эталонных примеров и сравнить долю верных ответов, ответов с правкой и опасных ошибок. Впечатление от двух-трёх удачных запусков не показательно: правка часто чинит один случай и ломает другие.
Игорь 12 лет занимается разработкой коммерческих сайтов: интернет-магазины, каталоги с обменом данными, корпоративные сайты и посадочные страницы под рекламу. Работал и на стороне подрядчика, и внутри компании-заказчика, поэтому хорошо понимает обе стороны конфликта «разработчики против маркетинга». В Media Monster руководит отделом разработки и отвечает за то, чтобы сайт создавался под продвижение, а не вопреки ему.
С какими задачами к нему приходят
Самая частая — «сделали редизайн, и просел трафик». Причины почти всегда одни и те же: сменились адреса страниц без переадресации, пропали тексты и заголовки, часть страниц закрылась от индексации при переносе с тестовой площадки. Вторая по частоте — «сайт не даёт добавить нужные страницы»: система управления не позволяет создавать разделы под спрос, и продвижение упирается в потолок платформы.
Отдельная категория — интеграции: наличие и цены должны приезжать из учётной системы, заявки — уходить в CRM, звонки — привязываться к источникам. Здесь основная работа не в коде, а в согласовании: какие данные передаются, как часто и что считать ошибкой обмена.
И, наконец, приходят с брошенными проектами: разработчик пропал, доступов нет, сайт работает, но менять его некому.
Как работает
Начинает не с макета, а со структуры. Пока не понятно, какие страницы нужны и под какой спрос, рисовать дизайн преждевременно: структура определяет и шаблоны, и объём работ, и способ вывода товаров. На проектах, где продвижением занимается другая команда, требует, чтобы карта страниц была согласована до старта вёрстки — иначе через полгода приходится переделывать.
Второй принцип — сдавать по чек-листу. После каждой выкладки проходится список технических проверок на боевом сайте: доступность страниц, файл robots.txt, метатеги, адреса, карта сайта, счётчики. Проверку делает не тот, кто выкладывал.
Третье — доступы принадлежат клиенту. Домен, хостинг, панель управления, репозиторий оформляются на владельца бизнеса с самого начала, а не «когда закончим».
Чего не делает
Не запускает сайт без плана переноса, если у проекта уже есть трафик: сопоставление старых и новых адресов делается до выкладки, а не после падения. Не строит каталог на решениях, которые не позволяют управлять адресами и метатегами страниц. Не берёт проект, где заказчик не готов выделить человека для сбора данных о товарах, — без характеристик и фотографий каталог всё равно не заработает, и срок сорвётся не по вине разработки.
В блоге
Пишет в рубрику «Разработка»: разборы переездов и редизайнов, чек-листы приёмки, интеграции с учётными системами, кейсы проектов. Все клиентские истории публикуются обезличенно — без названий, доменов и регионов.
Портрет автора — иллюстрация, а не фотография.
Материал подготовлен по редакционной политике блога: практика проектов, документация сервисов и проверка перед публикацией.
- Структура каталога, собранная из спроса, а не из выгрузки
- Ускорение загрузки первого экрана
- Интеграция форм с CRM без потери источника
- Редизайн без переноса структуры и адресов
- Тяжёлые изображения и скрипты «на всякий случай»
- Формы без передачи источника заявки
Что делать дальше
₽Посчитать экономикуСходится ли реклама при вашем чеке
?Задать вопросОтветим по вашей ситуации
Опишите задачу в двух словах — специалист ответит в Telegram, обычно в течение рабочего дня. Без презентаций и обязательств.
Написать в Telegram ↗✓Заявка на продвижениеОценить мой сайт
Бесплатно оценим текущее состояние и риски — до того, как вы начнёте что-то менять.
Поставьте оценку — она поможет редакции улучшать следующие разборы.
Обсуждение 0
Спросите, что осталось непонятным — автор материала отвечает в комментариях.
Читайте по теме
Игорь Волков13 мин · 22 августа 2026
Ключевая тема материала. Откуда нейросеть берёт факты о вашей компании: иллюстрация к статье «База знаний для нейросети: как перестать быть компанией, про которую всё придумано»
Проблема и точка потери. Шаг 1. Инвентаризация: 40 фактов вместо 40 страниц текста: иллюстрация к статье «База знаний для нейросети: как перестать быть компанией, про которую всё придумано»
Аудитория и сценарий выбора. Шаг 1. Инвентаризация: 40 фактов вместо 40 страниц текста: иллюстрация к статье «База знаний для нейросети: как перестать быть компанией, про которую всё…
Структура решения. Шаг 2. Формулируем так, чтобы факт можно было процитировать: иллюстрация к статье «База знаний для нейросети: как перестать быть компанией, про которую всё придумано»
Анна Соколова9 мин · 22 августа 2026
Ключевая тема материала. Что машина делает лучше человека: объём, вариации, перебор смыслов: иллюстрация к статье «Генерация объявлений нейросетью: что можно доверить машине, а что…
Проблема и точка потери. Рамка задания: минимальный набор данных о бизнесе на входе: иллюстрация к статье «Генерация объявлений нейросетью: что можно доверить машине, а что переписывать…
Аудитория и сценарий выбора. Рамка задания: минимальный набор данных о бизнесе на входе: иллюстрация к статье «Генерация объявлений нейросетью: что можно доверить машине, а что…
Структура решения. Приёмка текста: чек-лист проверок перед загрузкой в кампанию: иллюстрация к статье «Генерация объявлений нейросетью: что можно доверить машине, а что переписывать руками»
Дарья Лебедева14 мин · 22 августа 2026
Ключевая тема материала. Почему «стало быстрее» — это не измерение: иллюстрация к статье «Сколько на самом деле экономит ИИ: как посчитать часы и деньги»
Проблема и точка потери. Почему «стало быстрее» — это не измерение: иллюстрация к статье «Сколько на самом деле экономит ИИ: как посчитать часы и деньги»
Аудитория и сценарий выбора. Полный цикл задачи: задание, генерация, правки, проверка фактов: иллюстрация к статье «Сколько на самом деле экономит ИИ: как посчитать часы и деньги»
Структура решения. Замер на пяти задачах: как собрать данные за две недели: иллюстрация к статье «Сколько на самом деле экономит ИИ: как посчитать часы и деньги»
