Правила написания инструкций

Важные моменты, которые следует соблюдать при написании инструкции:

1. Лаконичность и простота.

2. Точность и полнота.

3. Недвусмысленность.

Лаконичность и простота

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

Например:

❌ Плохая инструкция

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

Инструкция перегружена ненужными деталями и отвлекает модель от основной задачи — квалификации клиента по критериям. Она включает лишние моменты, такие как мнение клиента о бренде, которые на этапе квалификации не являются критичными.

✅ Хорошая инструкция

Определи, соответствует ли потенциальный клиент критериям BANT (Бюджет, 
Полномочия, Потребность, Тайминг) на основе предоставленной информации.

Модель получает конкретное указание использовать проверенную методологию квалификации клиентов (BANT), что позволяет ей сфокусироваться на ключевых критериях и быстро оценить перспективы клиента.

Еще один вариант этой же инструкции:

❌ Плохая инструкция

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

✅ Хорошая инструкция

Шаг за шагом выясни у клиента (если это ранее еще не известно):
1. Какой у клиента бюджет?
2. Кто в команде отвечает за бюджет?
3. Сроки принятия решения
4. Нравится ли наш продукт?
5. Что они думают о нашем бренде?

Фраза "шаг за шагом" позволяет задавать вопросы последовательно, не все сразу. Фраза "если это ранее еще не известно" позволяет исключить повторное задавание вопроса агентом, если ранее клиент уже сообщил об этом.

Точность и полнота

В инструкции важно описывать точные формулировки. Любая обобщенность будет снижать качество ответов. Например, если вам надо последовательно выяснить у клиента какую-либо информацию (ФИО, телефон, паспортные данные):

❌ Плохая инструкция

Запроси у клиента ФИО, телефон, паспортные данные.

✅ Хорошая инструкция

Запроси у клиента информацию, шаг за шагом, задавая следующий вопрос только 
после его ответа:
- ФИО
- телефон 
- паспортные данные (серию и номер).

Если вы не используете конструкцию шаг за шагом, агент выдаст список вопросов сразу одним сообщением.

Или ещё пример, когда нужно, чтобы агент здоровался с клиентом:

❌ Плохая инструкция

Всегда здоровайся с клиентом.

✅ Хорошая инструкция

Всегда здоровайся с клиентом при начале диалога.

Если оставить плохой вариант, агент может здороваться при каждом ответе. Он понимает инструкцию буквально.

Недвусмысленность

Часто встречающаяся ошибка - дублирование или противоречие одной и той же инструкции в разных ее частях.

Например, вы описали как рассчитывается стоимость, проверили, все работает. Но потом вдруг через какое-то время добавили еще один кусок инструкции, который по смыслу не связан с первым, но в нем есть какой-то элемент про стоимость.

Ниже пример данной ситуации:

Первоначальный промт

#РАСЧЕТ СТОИМОСТИ АРЕНДЫ БАЙКА:
- Проверьте наличие доступных моделей на складе.
- Чтобы рассчитать стоимость запрашиваемых моделей, 
вызовите функцию cost_calculation в формате: 
Список моделей (например: nmax, pcx, scoopy), количество дней.

Промт с ошибкой

#РАСЧЕТ СТОИМОСТИ АРЕНДЫ БАЙКА:
- Проверьте наличие доступных моделей на складе.
- Чтобы рассчитать стоимость запрашиваемых моделей, 
вызовите функцию cost_calculation в формате: 
Список моделей (например: nmax, pcx, scoopy), количество дней.

#НАЛИЧИЕ МОДЕЛЕЙ:
Если клиент указал точное название моделей, которые он хочет забронировать, 
или уточнил цену:
1. Проверьте наличие моделей с помощью функции models_availability, 
передав туда список моделей (не более трех). 
2. ВСЕГДА указывайте информацию ТОЛЬКО о доступных моделях.
3. Чтобы рассчитать стоимость запрашиваемых моделей, 
вызовите функцию cost_calculation в формате: 
Список моделей (например: nmax, pcx, scoopy), количество дней.

Из-за этого пункта агент при запросе стоимости сначала начнёт проверять доступность, так как пункт о расчёте стоимости был продублирован и находится ниже:

Поэтому важно избегать дублирования информации и неоднозначных формулировок. Чем точнее, лаконичнее и более однозначно написан запрос, тем более стабильными и прогнозируемыми будут ответы от модели.

Использование утвердительных форм вместо отрицательных

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

Например:

❌ Плохая инструкция

Не говори клиенту информацию о наших реквизитах.

✅ Хорошая инструкция

Тебе запрещено предоставлять информацию о реквизитах компании.

Промпты

Ниже представлены промпты, которые будут полезны в определенных ситуациях:

"Шаг за шагом, только после ответа собеседника" - позволяет задавать вопросы последовательно, после ответа клиенте

"... если это ранее еще не известно из контекста диалога" - позволяет исключить повторные вопросы от агента, если клиент ранее уже ответил на них в процессе своего вопроса или нашего диалога

"Всегда" - позволяет повысить фокуса модели, когда важно учитывать какой-то пункт

"Если клиент написал ....." - позволяет создать условия срабатывания того или иного ответа