Аудит инструкции ИИ-агента: проверка промпта на противоречия
Что находит аудит инструкции ИИ-агента: противоречия, дубли, функции с одинаковым описанием и правила не по адресу. Что делать с результатом.
Аудит инструкции — встроенная проверка, которая читает системный промпт, функции и файлы базы знаний целиком и ищет противоречия, дубли, неполные разделы и путаницу в названиях функций. За минуты она находит то, что накопилось за месяцы ручных правок, и сама предлагает исправленный текст — который стоит прочитать, прежде чем нажимать «Применить».
Инструкцию редактируют по одной строке за раз: под конкретного клиента добавили правило, через месяц ещё одно, через полгода десятое. Файл целиком уже никто не перечитывает, и где-то в середине живёт абзац, который прямо спорит с третьим сверху. Агент читает всё разом и выполняет то указание, которое технически оказалось ближе к моменту вызова функции.
Что проверяет аудит инструкции
Аудит инструкции — это встроенная в кабинет проверка: она разбирает системный промпт, подключённые функции и файлы базы знаний одним проходом. Проверяются логика структуры, полнота ключевых разделов, дублирование смыслов, противоречия, избыточные и неясные формулировки, читаемость текста для модели, совпадение названий функций с реальными. После разбора платформа сразу предлагает исправленный вариант той же инструкции.
Кнопка «Аудит инструкции» лежит в разделе «Инструкция». Проверка расходует токены по обычному тарифу платформы: это разбор всей конфигурации агента целиком, и на него уходит до десяти минут. Полный список того, что проверяет расширенный режим, — в руководстве Савви.
| Режим | Что делает | Когда выбирать |
|---|---|---|
| Базовый, без файлов базы знаний | упорядочивает разделы, убирает повторы, чинит формулировки | инструкция разрослась, а база знаний уже в порядке |
| Расширенный, с генерацией базы знаний | делает то же самое и создаёт файлы Быстрых ответов из справочных кусков текста | в инструкции годами копился справочный текст |
Проверьте на своих диалогах.Регистрация без карты, 500 ₽ на тест по промокоду BLOG500
Собрать агентаОткуда в инструкции берутся противоречия за полгода правок
Противоречие почти никогда не пишут одним махом — оно собирается из двух правок, сделанных в разные месяцы по разным поводам. В одном месте написано звать менеджера при вопросе о цене, в другом — называть цену из прайса: обе строки когда-то были правильным решением для своей ситуации, вместе они спорят друг с другом.
В документации Савви разобран характерный пример такой поломки: агенту было велено вызвать функцию записи сразу при квалификации клиента и одновременно — сначала уточнить детали перед тем же вызовом. Диалог останавливается с ошибкой о двойном вызове одной функции с одинаковыми аргументами, потому что модель честно попыталась выполнить оба указания подряд.
Правило «внутри нет противоречий» из статьи про семь правил рабочей инструкции существует именно ради такого случая. Руками конфликт ловится, пока файл умещается на одном экране; у инструкции, которую правили десять раз, экрана давно не хватает.
Дубли и функции с одинаковыми описаниями
Второй частый диагноз — дублирование: одно и то же правило сформулировано дважды разными словами в разных блоках инструкции, и оба варианта живут годами — проще дописать новый абзац при очередной правке, чем искать старый. Аудит помечает такие пары смыслов и предлагает оставить один вариант.
Отдельно проверяются названия функций: у двух действий в кабинете может оказаться почти одинаковое описание, и агент путает, какое из них вызывать на похожий запрос клиента. Аудит сверяет текст инструкции с реальным списком подключённых функций и находит места, где названия внутри промпта разошлись с тем, что настроено в кабинете.
Какие правила аудит переносит в базу знаний
Расширенный режим аудита сразу выделяет куски инструкции, которые стоит превратить в файлы Быстрых ответов, и создаёт их сам. Обычно это справочный текст: условия доставки, ответы на частые вопросы, разъяснения по регламенту.
Такой текст не влияет на логику диалога, зато оплачивается токенами в каждом сообщении, пока лежит внутри промпта, — файл базы знаний агент подгружает только тогда, когда клиент об этом спросил. Здесь аудит применяет тот же принцип, что разбирает статья о том, как писать промпты: факты — работа базы знаний, а инструкция должна оставаться короткой, потому что читается моделью в каждом сообщении.
При этом вес инструкции никуда не девается: правило Савви говорит прямо — при споре между документом и текстом инструкции побеждает инструкция. Перенос куска текста в файл убирает его из платного объёма промпта, не меняя это старшинство.
Что делать с результатом аудита
Результат аудита — черновик, который стоит прочитать целиком перед применением. Платформа сама предупреждает об этом в интерфейсе, до кнопки «Применить».
Аудит переписывает формулировки, опираясь на текст самой инструкции. Если в исходнике уже была смысловая ошибка, модель её не поймает: у неё нет доступа к вашему прайсу или к разговору с клиентом, из-за которого спорная строка когда-то появилась. Просмотр результата — единственный момент, где это ещё можно заметить.
Что сделать с инструкцией прямо сейчас
Подставьте вашу текущую инструкцию в аудит и сначала прочитайте список найденного, не нажимая «Применить»: за пару минут станет видно, сколько противоречий и дублей накопилось в файле без вашего ведома.
Если после правки захочется проверить, выдержит ли обновлённый текст живой поток обращений, двенадцать реплик для такого прогона собраны в статье о том, как протестировать ИИ-агента.
Частые вопросы
Что проверяет аудит инструкции ИИ-агента
Он разбирает системный промпт вместе с подключёнными функциями и файлами базы знаний и ищет логику структуры, полноту разделов, дублирование смыслов, противоречия, избыточные формулировки, читаемость для модели и совпадение названий функций с реальными. После разбора платформа сразу предлагает исправленный вариант инструкции.
Сколько времени занимает аудит инструкции
До десяти минут — это разбор всей конфигурации агента, не мгновенная проверка синтаксиса. Проверка расходует токены по стандартному тарифу платформы, как и любой другой запрос к модели.
Чем базовый режим аудита отличается от расширенного
Базовый режим упорядочивает разделы инструкции, убирает повторы и чинит формулировки, не трогая базу знаний. Расширенный режим делает то же самое и создаёт файлы для раздела Быстрых ответов из кусков текста, которым лучше живётся отдельно от промпта.
Нужно ли проверять результат аудита перед применением
Да, руководство Савви прямо рекомендует перед нажатием «Применить» свериться по четырём пунктам: не потерялись ли важные ограничения, не изменился ли тон общения, не были ли удалены критичные для вашего кейса формулировки и правильно ли учтены функции и структура базы знаний.
Может ли аудит сам исправить противоречие в инструкции
Да, после анализа платформа сразу показывает исправленный текст с упорядоченными разделами и убранными повторами. У модели при этом нет доступа к прайсу или переписке, из которой спорная формулировка когда-то появилась, поэтому итоговое решение остаётся за тем, кто применяет результат.
Что делать с файлами, которые аудит создал в Быстрых ответах
Их стоит отдельно перепроверить — руководство отмечает это уже после шага применения результата. Расширенный режим переносит в файлы справочный текст вроде условий и частых вопросов, и там же стоит убедиться, что формулировки не потеряли точность при переносе.
Читайте дальше
Все статьи темы →
Инструкция для ИИ-агента: 7 правил и шаблон
Из чего состоит инструкция ИИ-агента, почему она главнее базы знаний, семь правил рабочего промпта и готовый шаблон для кабинета.
Как писать промпты: от запроса к рабочей инструкции
Чем разовый промпт отличается от системного, как устроена структура инструкции для ИИ-агента, почему правила конфликтуют между собой и как понять, что промпт стал слишком длинным.
Как протестировать ИИ-агента до встречи с клиентами
Три уровня проверки перед запуском ИИ-агента: тестовый чат, обкатка на живых обращениях без отправки ответов, вывод на часть трафика. Двенадцать реплик для прогона.
