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

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

Лучшие практики

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

Пример грамотно составленной инструкции можно увидеть здесь.

Почему хороший пример работает

Хорошая инструкция полезна, когда:

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

Пример плохой инструкции

Плохая инструкция слишком общая:

Отвечай клиентам хорошо и продавай лучше.
Будь умным, активным и не ошибайся.

Почему это плохой пример:

• непонятно, что именно должен делать бот;
• нет порядка действий;
• нет ограничений;
• слова "хорошо" и "лучше" можно понять по-разному.

Как понять, что инструкция написана хорошо

Инструкция написана хорошо, если после чтения понятно:

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

Если инструкция оставляет много вопросов, лучше уточнить ее до запуска.