Как написать инструкцию

Чтобы ИИ-агент отвечал так, как вам нужно.

Зачем нужна структура

Если писать инструкцию сплошным текстом, ИИ не понимает, где заканчивается описание роли и начинаются правила. Поэтому инструкцию стоит разбивать на блоки:

  • Роль: кто этот агент и в чём он разбирается.

  • Задача: что конкретно он должен делать.

  • Правила: что можно, а что нельзя.

  • Примеры: как должен выглядеть хороший ответ.

  • Перенаправление: что делать, если агент не может помочь.

  • Формат ответа: в каком виде выдавать результат.

Не обязательно использовать все блоки. Берите то, что подходит под вашу задачу.

Шаг 1. Роль и стиль агента

Роль — это первое, что стоит написать в инструкции. Она объясняет ИИ, кем он работает и как себя вести. Задавайте роль конкретно: не «агент», а «консультант по внутренним процессам компании».

✗ Плохо: Если пользователь задаёт вопрос, будь консультантом компании.

✓ Лучше: Вы — эксперт-консультант по внутренним процессам компании. Отвечайте кратко, точно и на русском языке.

Что стоит указать в роли:

  • Область: юристы, закупки, внутренние процессы, поддержка.

  • Тон: деловой, краткий, спокойный, без разговорных выражений.

  • Язык, если он важен.

Шаг 2. Задача: что агент должен делать

Задача — это ответ на вопрос: какой результат пользователь получит после обращения к агенту? Формулируйте через действие: «проанализируй», «составь список», «проверь на ошибки». Чем конкретнее задача, тем точнее ответ.

✗ Плохо: Работай с запросами.

✓ Лучше: Твоя основная задача — проводить первичный анализ проекта договора поставки и формировать структурированный чек-лист замечаний и рисков для сотрудника, который его запросил.

Шаг 3. Правила поведения

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

✗ Плохо: Отвечай хорошо и профессионально.

✓ Лучше: Отвечайте кратко и по делу. Не используйте эмодзи.

✓ Лучше: Отвечайте максимум в 3 предложения. Не давайте юридических заключений — только перечень рисков.

«Профессионально» — расплывчато.

«Без эмодзи, только перечень рисков» — понятно и вам, и ИИ. Если что-то запрещаете, сразу напишите, как надо.

Приоритеты: если правил много, укажите, какие важнее. Иначе ИИ сам решит, что главное.

Шаг 4. Примеры ответов

Примеры — самый быстрый способ показать ИИ, как именно вы хотите, чтобы он отвечал. Дайте 2–5 коротких примеров, похожих на реальные запросы. Покажите и обычные ситуации, и те, где агент должен отказать или перенаправить.

Вопрос: В договоре нет пункта об ответственности за просрочку — это нормально?

Ответ: Это риск. В чек-листе это будет отмечено как замечание — рекомендую добавить пункт о штрафных санкциях.

Вопрос: Кто отвечает за пункт, которого нет в базе знаний?

Ответ: В базе знаний нет информации по этому вопросу. Обратитесь к руководителю отдела продаж.

Вопрос: Можешь сам согласовать этот договор?

Ответ: Нет. По вопросам согласования обратитесь к уполномоченному сотруднику юридического отдела.

Не гонитесь за количеством: если примеров слишком много, ИИ начинает копировать их детали вместо того, чтобы следовать общей логике.

Шаг 5. Перенаправление: когда агент не может помочь

Заранее пропишите, что агент должен делать, когда не может ответить. Привязывайте правило не к «знаниям» ИИ, а к конкретной ситуации. ИИ почти никогда не считает, что «не знает».

✗ Плохо: Если ты не знаешь ответа, скажи сотруднику обратиться в юридический отдел.

✓ Лучше: Если ответа нет в базе знаний , скажи сотруднику обратиться в юридический отдел.

Принцип: не «если ИИ не знает X — сделай Y», а «при ситуации X — сделай Y».

Шаг 6. Формат ответа

Если не указать формат, ИИ будет отвечать как хочет: то списком, то длинным текстом, то таблицей. Опишите формат явно:

  • Для обычного ответа: один абзац или короткий список.

  • Для классификации укажите конкретные поля: тема, тип риска, приоритет.

  • Для интеграций: JSON, если система дальше обрабатывает ответ автоматически.

  • Для длинных объяснений задайте лимит: до 500 символов, до 5 пунктов.

Не задавайте два формата одновременно: «отвечай одним абзацем» и «выведи таблицу», ИИ выберет что-то одно сам.

Шаг 7. Как оформлять инструкцию

Используйте заголовки с решёткой (#) – это Markdown-разметка. С ней ИИ точнее понимает, где кончается одна часть и начинается другая:

# Роль

# Задача

# Правила

# Примеры ответов

# Формат ответа

Частые ошибки

Если агент отвечает не так, как вы ожидаете, скорее всего причина в одной из этих ошибок:

  • Пишете «если ты не знаешь» вместо «если ответа нет в базе знаний». ИИ почти никогда не считает, что не знает — он просто придумает ответ.

  • Смешиваете всё в один абзац. Разбейте инструкцию на блоки.

  • Используете размытые правила вроде «отвечай профессионально». Пишите конкретно.

  • Даёте слишком много примеров. 2–5 примеров достаточно.

  • Формат в правилах не совпадает с форматом в примерах.

Простой тест: покажите свою инструкцию коллеге. Если он понимает, что агент должен делать, тогда ИИ тоже поймёт.