Основной промпт - только одно из мест, где могут находиться инструкции: агент также получает их через слоты промпта, поиск по базе знаний, сценарий работы.
Этот документ описывает архитектуру инструкций агента: какие каналы существуют, на каких этапах работы они используются, как долго действуют и какие типы правил следует размещать в каждом из них. Правильное распределение инструкций позволяет сохранять предсказуемость поведения агента и упрощает поддержку его настроек по мере роста их сложности.
Распределенные инструкции
Инструкции нужно распределять по назначению, видимости и времени жизни.
Если перегружен один канал - особенно основной промпт - агент теряет фокус, застревает в многословных инструкциях и игнорирует детали. Отдельные правила должны быть заметны именно там, где они важнее всего.
Влияние инструкции зависит от четырех вещей: где она размещена в общем объеме инструкций агента, когда становится видимой, насколько близка к текущему моменту диалога и как долго остается активной.
Не стоит помещать все инструкции в основной промпт. Общие правила работы, позиционирование агента и требования безопасности действительно должны находиться там, однако инструкции, связанные с конкретными задачами или контекстом, лучше размещать ближе к месту их использования. Чем ближе инструкция к моменту выполнения задачи, тем более конкретной и ориентированной на действие она может быть.
Обзор каналов инструкций
| Канал | Для чего использовать | Видимость и время жизни | Пример |
|---|---|---|---|
| Основной промпт | Базовые настройки агента: личность, роль, ключевые задачи, границы и общие принципы работы | Виден агенту всегда; широкий фоновый контекст на все время работы агента | "Ты Марк, ассистент по недвижимости. Не давай юридических консультаций." |
| Дополнительные слоты промпта | Контекстные инструкции, помещенные рядом с соответствующими данными и настройками агента. Они позволяют уточнять правила форматирования сообщений, особенности работы в рабочее и нерабочее время, а также инструкции по использованию данных клиента или каталога товаров. | Некоторые слоты присутствуют всегда и могут дополнять базовые инструкции агента; другие показываются только если активен соответствующий слот | Рабочее время: "В рабочее время можно переводить сложные вопросы на оператора" |
| База знаний | Подробные инструкции, часто задаваемые вопросы, описания товаров и услуг, регламенты, описания процедур, которые загружаются только при необходимости. | Не видна сразу. Агент получает эти инструкции самостоятельно через поиск по базе знаний во время работы с запросами клиента | "Для определения зон доставки и их стоимости ищи в базе знаний документ 'Способы доставки'" |
| Описание шага сценария | Описание для агента конкретного видимого шага сценария: когда и как его вызывать, какие данные собирать и как работать с ним на уровне сценария. Агент должен выбирать, какие из шагов сценария вызывать на основе их описания | Видна агенту всегда, пока виден этот шаг сценария, до его вызова (холодный контекст) | Инструкция шага: "Уточни у клиента имя и телефон." |
Действие Добавить инструкцию |
Горячая директива, полученная из действия шага сценария: короткое конкретное действие, которое агент должен выполнить сразу после успешного выполнения шага | Показывается агенту на один ход его работы; высокий приоритет, короткое время жизни | "Найди в системе заказ клиента и проверь в нем адрес доставки." |
Действие Перейти к другому шагу |
Горячая инструкция перехода к следующему шагу сценария, которую агент получает после успешному выполнения текущего шага | Показывается в дашборде до тех пор, пока агент не вызовет указанный целевой шаг | "Переходи к расчету стоимости доставки после проверки адреса клиента." |
Действие Изменить контекст сценария |
Постоянный горячий контекст, записанный в память агента в результате выполнения шага: важная сценарная информация, которая должна оставаться перед глазами агента при работе со следующими шагами | Инструкция появляется после вызова соответствующего действия. Продолжает работать, пока другой вызов этого действия не очистит или не перезапишет ее; имеет очень сильное влияние | Например, выбранные названия товаров, согласованные ограничения по доставке, оформленный в процессе работы заказ. |
| Сигналы | Фоновые поведенческие триггеры для реализации сложных условных правил, автоматических реакций и изменения поведения агента при обнаружении определённых состояний | После обнаружения системой название и значение сигнала показываются агенту. Сигналы могут запускать шаги сценария, которые добавляют горячие инструкции через действия | Сигнал: "Настроение клиента = раздражен". Действие Добавить инструкцию: "Предложи перевести диалог на оператора." |
| Дашборд работы агента | Динамическая сводка текущего состояния агента: активные задачи, недостающие данные, текущий этап сценария, горячие инструкции, значения сигналов и результаты выполнения шагов | Постоянно обновляется и содержит информацию, актуальную для текущего этапа работы со сценарием. Оказывает сильное влияние на действия агента, пока остаются нерешённые задачи | Сигнал: "Настроение клиента" = раздражен. Недостающее поле: phone. Следующий шаг: ConfirmDeliveryAddress. |
Основной промпт
Основной промпт — это главный источник постоянных инструкций агента. Он определяет его роль, задачи, общие правила поведения и границы ответственности. В отличие от шагов сценария, сигналов и временных инструкций, основной промпт присутствует в работе агента постоянно и влияет на все диалоги.
Основной промпт лучше всего подходит для информации, которая должна оставаться актуальной независимо от текущего сценария, этапа диалога или состояния клиента.
Рекомендуемая структура
Структура может отличаться в зависимости от задачи агента, однако обычно полезно придерживаться следующего порядка:
- Идентичность и роль агента
- Основная задача и цели работы
- Общие правила общения и поведения
- Основные обязанности агента
- Ограничения и требования безопасности
- Краткое описание предметной области
- Правила использования базы знаний и других источников информации
Использование заголовков и логических разделов упрощает поддержку инструкций и помогает избежать противоречий по мере роста конфигурации агента.
Что рекомендуется размещать в основном промпте
Основной промпт особенно хорошо подходит для следующих типов информации:
- роль и позиционирование агента;
- описание компании или бизнеса;
- основные задачи агента;
- правила общения с клиентами;
- общие требования к качеству ответов;
- ограничения и правила безопасности;
- описание доступных источников знаний;
- общие принципы использования сценариев и инструментов.
Такие инструкции редко меняются во время работы агента и должны одинаково применяться во всех диалогах.
Что лучше выносить в другие механизмы
Основной промпт не предназначен для хранения всей логики работы агента.
Следующие типы информации обычно удобнее размещать в других компонентах системы:
- подробные описания товаров и услуг, частые вопросы и ответы — в базе знаний;
- многоэтапные процессы и последовательности действий — в сценариях;
- временные указания для текущего этапа работы — действие
Добавить инструкцию; - переходы между этапами сценария — действие
Перейти к другому шагу; - долгоживущий контекст диалога — действие
Изменить контекст сценария; - автоматическое обнаружение состояний и условий — через сигналы.
Такое разделение позволяет поддерживать основной промпт компактным и сосредоточенным на постоянных правилах работы агента.
Практические рекомендации
Основной промпт рекомендуется рассматривать как описание личности, обязанностей и общих принципов работы агента, а не как место для хранения всех возможных инструкций системы.
Если определённое правило относится только к отдельному сценарию, состоянию клиента или этапу диалога, обычно существует более подходящий механизм, чем добавление этого правила в основной промпт.
Для особенно важных правил допускается дублирование инструкций в нескольких местах. Например, ключевое требование может быть указано как в основном промпте, так и в инструкции соответствующего шага сценария.
Дополнительные слоты промпта
Помимо основного промпта агент может получать дополнительные инструкции через специализированные слоты. Каждый слот предназначен для определённого типа контекста и подключается только при выполнении соответствующих условий.
Такое разделение позволяет хранить инструкции рядом с областью их применения и не перегружать основной промпт правилами, которые нужны только в отдельных ситуациях.
Когда используются слоты
| Слот | Когда доступен агенту | Основное назначение |
|---|---|---|
Основной промпт |
Всегда | Основные инструкции, роль, задачи и общие правила поведения агента |
Рабочее время |
Во время рабочего времени и только если слот заполнен | Особенности работы в рабочее время |
Нерабочее время |
Вне рабочего времени и только если слот заполнен | Поведение агента в нерабочее время |
База знаний |
Всегда | Дополнительные инструкции по использованию базы знаний |
Формат ответов |
Всегда | Правила оформления и структуры ответов |
Работа с каталогом |
Только при включённой работе с каталогом | Правила взаимодействия с подагентом для работы с каталогом товаров |
Каталог товаров |
Только во время работы подагента для работы с каталогом | Настройка поиска и подбора товаров, сборка списка товарных позиций для корзины или заказа |
Информация о клиенте |
Только если слот заполнен | Правила использования данных клиента из CRM |
Особенности работы слотов
Слот Основной промпт является основным источником постоянных инструкций и сильнее всего влияет на общее поведение агента. Именно здесь обычно размещаются роль агента, его задачи, ограничения и общие правила общения.
Слоты База знаний и Формат ответов доступны агенту постоянно. Они позволяют дополнять встроенные механизмы работы с базой знаний и форматированием ответов пользовательскими инструкциями.
Слоты Рабочее время, Нерабочее время и Информация о клиенте подключаются только при добавлении их в настройках агента.
Слоты, связанные с каталогом товаров, используются только при включённой работе с каталогом. Слот Работа с каталогом настраивает взаимодействие основного агента с подагентом для работы с каталогом, а слот Каталог товаров настраивает работу самого подагента, отвечающего за поиск товаров, подбор позиций и формирование корзины заказа.
Как использовать каждый слот
Основной промпт
Основной слот агента. Содержит его роль, задачи, ограничения и общие правила поведения.
Этот слот используется во всех диалогах и сильнее остальных влияет на общее поведение агента. Именно здесь рекомендуется описывать идентичность агента, его обязанности, правила общения и другие инструкции, которые должны применяться независимо от сценария, времени суток или состояния клиента.
Подробные рекомендации по настройке основного промпта приведены в разделе «Основной промпт».
Рабочее время / Нерабочее время
Слоты для настройки поведения агента в зависимости от рабочего времени.
В каждый момент времени агент получает только один из этих слотов: для рабочего или для нерабочего времени. Какой именно слот будет использован, определяется расписанием, настроенным в системе. Если соответствующий слот не заполнен, дополнительные инструкции не добавляются.
Эти слоты подходят для правил, которые должны меняться в зависимости от доступности сотрудников или внутренних процессов компании. Например:
- можно ли переводить диалог на менеджера;
- нужно ли сообщать клиенту о рабочем времени;
- следует ли собирать контакты для обратной связи;
- можно ли создавать напоминания или задачи на следующий рабочий день;
- какие ожидания по срокам ответа необходимо сообщать клиенту.
Использовать такие слоты рекомендуется в случаях, когда агент работает круглосуточно, но его поведение должно учитывать график работы компании.
База знаний
Слот предназначен для настройки работы агента с базой знаний.
Система автоматически предоставляет агенту информацию о доступных документах и механизмах поиска по ним. Пользовательская часть слота позволяет дополнительно объяснить структуру базы знаний и особенности предметной области.
Здесь рекомендуется описывать:
- наиболее важные документы;
- внутренние термины и сокращения компании;
- названия продуктов, услуг и процессов;
- соответствие между формулировками клиентов и терминологией документации;
- документы, которые следует считать основным источником информации по отдельным темам.
Этот слот особенно полезен, когда клиенты используют одну терминологию, а документация компании — другую. Правильно настроенный слот помогает агенту связывать вопросы клиентов с нужными разделами базы знаний и повышает качество поиска информации.
Формат ответов
Слот предназначен для настройки стиля и оформления ответов агента.
Базовые параметры общения задаются через настройки агента: язык, тон общения, длина ответов и правила разбиения сообщений. Данный слот позволяет дополнительно уточнить требования к оформлению ответов.
В этом слоте можно описывать:
- предпочтительный стиль общения;
- допустимый уровень формальности;
- использование эмодзи;
- оформление списков и структурированных ответов;
- особенности формулировок при подтверждениях, отказах или передаче диалога сотруднику;
- любые другие требования к внешнему виду сообщений.
Этот слот рекомендуется использовать для правил оформления ответов, а не для бизнес-логики или сценариев работы.
Работа с каталогом
Слот используется только при включённой работе с каталогом товаров или услуг.
Он предназначен для настройки взаимодействия основного агента со специализированным подагентом для работы с каталогом. Через этот слот можно объяснить, в каких ситуациях следует обращаться к каталогу и какие задачи необходимо передавать подагенту.
Здесь могут размещаться инструкции о том:
- когда следует искать товары или услуги в каталоге;
- какие типы запросов требуют обращения к каталогу;
- какие особенности каталога важно учитывать;
- как агенту действовать при подборе товаров или формировании корзины.
Если основной агент не всегда корректно использует каталог или пропускает ситуации, в которых следовало выполнить поиск товаров, дополнительные инструкции обычно следует добавлять именно в этот слот.
Каталог товаров
Слот предназначен для настройки самого подагента для работы с каталогом.
Подагент отвечает за поиск товаров и услуг, подбор подходящих вариантов и формирование корзины для последующего оформления заказа. Этот слот позволяет адаптировать его работу под особенности конкретного бизнеса и структуры каталога.
Здесь рекомендуется описывать:
- какие поля и свойства товаров наиболее надёжны;
- какие категории и признаки следует учитывать при поиске;
- особенности структуры каталога;
- правила работы с остатками и доступностью товаров;
- дополнительные критерии отбора результатов.
Этот слот особенно полезен для каталогов со сложной структурой, нестандартными названиями товаров или неполно заполненными карточками.
Информация о клиенте
Слот предназначен для настройки работы агента с данными клиента из CRM.
При активации агент получает краткую сводку по клиенту, которая может включать имя, контактные данные, адрес, теги и значения пользовательских полей CRM.
Пользовательская часть слота определяет, как агент должен использовать эту информацию во время общения.
Например, здесь можно описать:
- какую информацию следует использовать в приветствии клиента;
- на какие теги клиента агенту стоит обращать внимание;
- какие данные клиента особенно важны для работы агента;
- какие данные следует игнорировать в определённых ситуациях.
Этот слот рекомендуется использовать для правил интерпретации CRM-данных, а не для хранения самих данных клиента.
Инструкции сценария
Сценарий предоставляет несколько типов инструкций, которые влияют на поведение агента на разных этапах работы. Они отличаются моментом появления в контексте агента, длительностью действия и задачами, для которых предназначены.
При проектировании сценария важно понимать эту разницу и использовать каждый механизм по назначению. Это позволяет сделать поведение агента более предсказуемым и избежать перегрузки отдельных каналов инструкций.
Инструкции шага сценария
Инструкция шага объясняет агенту назначение шага сценария, условия его использования и данные, которые необходимо получить для его выполнения.
Такие инструкции доступны агенту до вызова шага и помогают ему ориентироваться среди доступных возможностей сценария. Агент использует их для принятия решения о том, какой шаг подходит для текущей ситуации и какие данные необходимо собрать у клиента.
Инструкции шага рекомендуется использовать для ответа на следующие вопросы:
- зачем нужен этот шаг;
- в каких ситуациях его следует вызывать;
- какие данные необходимо получить перед выполнением;
- какие действия ожидаются от агента на уровне сценария.
Инструкция шага не должна описывать внутреннюю реализацию действий системы. Агент работает со сценарием на уровне шагов и не знает, какие действия выполняются внутри шага после его успешного запуска.
Если шаг является важной точкой входа в сценарий, это рекомендуется явно указывать в его описании.
Двусторонняя подсветка
Для особенно важных действий полезно использовать несколько каналов инструкций одновременно.
Например, существование важного шага можно упомянуть в основном промпте агента и дополнительно подробно описать в инструкции самого шага. Такой подход снижает вероятность того, что агент пропустит нужную функциональность при работе со сценарием.
Действие Добавить инструкцию
Добавить инструкцию предназначено для добавления временных инструкций после выполнения шага сценария.
В отличие от инструкции шага, которая помогает принять решение о вызове шага, Добавить инструкцию влияет на то, что агент должен сделать дальше после завершения текущего этапа.
Обычно такие инструкции используются для:
- уточняющих вопросов клиенту;
- объяснения следующих действий;
- выполнения конкретной задачи после завершения шага;
- передачи дополнительного контекста между этапами сценария.
Инструкции этого типа должны быть короткими, конкретными и ориентированными на ближайшие действия агента.
Инструкции перехода в действии Перейти к другому шагу
Перейти к другому шагу используется для управления переходами между шагами сценария.
После выполнения шага агент получает информацию о следующем рекомендуемом шаге и может получить дополнительные пояснения о причинах такого перехода.
Если Добавить инструкцию отвечает на вопрос «что делать дальше», то Перейти к другому шагу отвечает на вопрос «куда двигаться дальше внутри сценария».
Этот механизм особенно полезен в многоэтапных сценариях, где порядок выполнения шагов имеет значение и должен контролироваться системой.
Постоянный контекст через действие Изменить контекст сценария
Изменить контекст сценария позволяет сохранять важную информацию в Workflow Dashboard и делать её доступной агенту на последующих этапах работы.
В отличие от временных инструкций, такой контекст сохраняется между шагами сценария и продолжает влиять на поведение агента до тех пор, пока не будет изменён или удалён.
Этот механизм удобно использовать для хранения:
- выбранных клиентом параметров;
- важных договорённостей;
- промежуточных результатов сценария;
- ограничений и предпочтений клиента;
- информации, которая потребуется на следующих этапах работы.
Поскольку такой контекст сохраняется длительное время, рекомендуется хранить в нём только действительно важную информацию и своевременно очищать устаревшие данные.
Сравнение инструкций сценария
Инструкция шага помогает агенту понять назначение доступных шагов и выбрать подходящее действие в соответствии с настроенным сценарием.
Действие Добавить инструкцию используется для передачи конкретной задачи, которую необходимо выполнить сразу после завершения текущего шага.
Действие Перейти к другому шагу управляет переходами между шагами сценария и помогает агенту двигаться по заранее определённой логике.
Действие Изменить контекст сценария служит для хранения важной информации между этапами сценария и формирует долговременную память агента в рамках текущего процесса работы.
При совместном использовании эти механизмы позволяют разделить постоянные правила, текущие задачи, навигацию по сценарию и долгосрочный контекст, не перегружая один источник инструкций всеми возможными требованиями.
Workflow Dashboard
Workflow Dashboard — динамическая сводка текущего состояния агента. В отличие от промпт-слотов и базы знаний, дашборд содержит информацию, актуальную для выполнения текущего сценария и регулярно обновляется в процессе работы.
Дашборд может содержать:
- текущие дату и время в часовой зоне CRM
- активные сигналы и их значения
- контекст, сохранённый через действие
Изменить контекст сценария - текущие задачи сценария
- заполненные и недостающие значения полей
- временные инструкции, добавленные через действие
Добавить инструкцию - активные переходы между шагами сценария
Дашборд оказывает существенное влияние на поведение агента, поскольку содержит наиболее актуальный операционный контекст. Именно на основе этой информации агент принимает решения о дальнейших действиях и выполнении сценария.
Рекомендуется поддерживать содержимое дашборда в актуальном состоянии и избегать накопления устаревших задач, инструкций и переходов. Избыточный или противоречивый контекст может негативно влиять на качество принимаемых агентом решений.
Особое внимание следует уделять использованию действия Изменить контекст сценария. Сохранённый таким образом контекст может длительное время оставаться доступным агенту и продолжать влиять на его поведение даже после завершения первоначальной задачи. Для долгоживущего контекста рекомендуется сохранять только действительно важную информацию и своевременно обновлять или удалять устаревшие данные.
Сигналы
Сигналы — это фоновые механизмы анализа переписки, позволяющие автоматически обнаруживать определённые состояния, события или шаблоны поведения клиента.
При срабатывании сигнал становится доступен агенту через дашборд и может влиять на его дальнейшие решения. Кроме того, сигнал может запускать скрытые шаги сценария, выполнять действия системы и добавлять временные инструкции для изменения поведения агента.
Сигналы удобно использовать для автоматического обнаружения состояний, которые сложно или нежелательно описывать напрямую в инструкциях агента: например, признаков недовольства клиента, повторных отказов, потенциально проблемных ситуаций, признаков ценного лида или условий для изменения стандартного сценария работы.
Подробные рекомендации по проектированию и настройке сигналов приведены в разделе «Сигналы».
Описания переменных шагов сценария
Подробное описание структуры шагов сценария, полей и вариантов выбора приведено в разделе «Шаги сценария».
Важно учитывать, что описания полей шагов сценария, доступных вариантов, а также правила запроса обязательных данных также являются частью системы инструкций агента. Они помогают ему понимать, какие данные необходимо получить от клиента, как заполнять поля шагов сценария и по каким признакам выбирать между доступными вариантами.
Чем точнее и конкретнее описаны поля и варианты выбора, тем стабильнее агент собирает данные и принимает решения во время выполнения сценария.
Как писать инструкции
Используйте понятные и конкретные формулировки
Инструкция должна описывать ожидаемое поведение агента максимально однозначно. Чем конкретнее сформулировано правило, тем стабильнее оно будет выполняться.
Плохо: "Будь полезным и хорошо отвечай"
Хорошо: "Если вопрос клиента требует уточнения, задай один уточняющий вопрос. После этого дай конкретный ответ и предложи следующий шаг."
Описывайте желаемое поведение
По возможности формулируйте инструкции через ожидаемый результат, а не через перечень запретов.
Плохо: "Не используй markdown"
Хорошо: "Отвечай простым текстом без форматирования"
Исключение составляют ограничения безопасности и другие правила, нарушение которых недопустимо.
Объясняйте причину правила
Если правило связано с особенностями бизнеса, обслуживания клиентов или внутренними требованиями компании, полезно кратко объяснить причину.
Плохо: "Не упоминай вес блюд"
Хорошо: "Не упоминай вес блюд. Клиенты выбирают блюда по составу и вкусу, а точные значения могут создавать неверные ожидания."
Понимание причины помогает агенту применять правило в похожих ситуациях.
Разделяйте инструкции по темам
Используйте заголовки и логические блоки для разных аспектов поведения агента. Не смешивайте в одном разделе описание роли агента, правила общения, бизнес-логику и примеры ответов.
Хорошо структурированные инструкции проще поддерживать и развивать по мере роста сценария.
Размещайте инструкции в подходящем месте
Не все правила должны находиться в основном промпте. Общие принципы работы и роль агента обычно располагаются в основных инструкциях, а правила, относящиеся к конкретным задачам или контексту, лучше размещать ближе к месту их применения: в слотах промпта, шагах сценария, сигналах или базе знаний.
Избегайте противоречий
Разные источники инструкций должны дополнять друг друга, а не конфликтовать между собой.
Если для отдельных ситуаций существуют специальные правила, рекомендуется явно определить их приоритет относительно общих инструкций.
Начинайте с простых инструкций
Во многих случаях агенту достаточно чётких правил и описания процесса работы. Дополнительные примеры поведения стоит добавлять только тогда, когда простых инструкций оказывается недостаточно для получения стабильного результата.
Определите поведение при отсутствии ответа
Важно заранее определить, как агент должен действовать в ситуациях, когда необходимая информация отсутствует.
Пример: "Если ответ отсутствует в базе знаний, сообщи об этом клиенту и предложи перевести диалог на сотрудника. Не придумывай информацию о товарах, ценах, сроках или условиях обслуживания."
Выбирайте подходящий язык инструкций
Инструкции, связанные с общением с клиентом, рекомендуется писать на языке целевой аудитории. Вопросы клиенту, шаблоны ответов и примеры сообщений также должны соответствовать языку общения.
Технические описания полей, правила валидации и служебные комментарии могут использовать язык, принятый в процессе настройки системы.
Симптомы и где искать причины
| Проблема | Возможная причина | Что проверить |
|---|---|---|
| Агент игнорирует общее правило | Правило потерялось среди большого количества инструкций или конфликтует с более приоритетными указаниями | Перенести правило в более подходящее место, упростить формулировку или продублировать его в связанном контексте |
| Агент придумывает информацию | Недостаточно явно описано, как действовать при отсутствии данных, или в базе знаний нет нужной информации | Добавить правило о недопустимости догадок и проверить содержимое базы знаний |
| Агент отвечает слишком подробно | Не настроены требования к формату ответов или инструкции содержат лишние детали | Настроить правила форматирования и добавить требования к объёму ответа |
| Агент не использует базу знаний | Не указано, когда следует обращаться к базе знаний, или формулировки в документах отличаются от вопросов клиентов | Добавить инструкции по использованию базы знаний и уточнить ключевые термины |
| Агент не вызывает нужный шаг сценария | Назначение шага описано недостаточно понятно или шаг недоступен в текущем состоянии сценария | Проверить доступность шага и уточнить его описание |
| Агент не переходит к следующему шагу | Не настроено условие перехода или оно сформулировано неоднозначно | Проверить логику переходов и связанные инструкции |
| Агент игнорирует временные инструкции | В контексте слишком много одновременно активных задач или присутствуют конфликтующие указания | Удалить устаревшие задачи и проверить активные инструкции |
| Агент продолжает использовать устаревшую информацию | Старый контекст не был очищен или обновлён | Проверить и обновить сохранённый контекст агента |
| Сигнал срабатывает, но поведение не меняется | Для обнаруженного состояния не настроены дальнейшие действия или инструкции | Проверить связанные шаги сценария и инструкции |
| Агент неправильно заполняет данные | Описание поля недостаточно точное или не содержит примеров | Уточнить описание поля и добавить примеры заполнения |
| Агент не запрашивает обязательные данные | Не настроен запрос недостающей информации или он сформулирован неясно | Проверить текст запроса и обязательность поля |
| Агент выбирает неправильный вариант | Варианты описаны слишком похоже или недостаточно подробно | Уточнить описание каждого варианта выбора |
| Агент путает похожие шаги | Названия или описания шагов слишком похожи друг на друга | Сделать названия и инструкции более различимыми |
| Агент действует слишком осторожно или пассивно | Инструкции и ограничения чрезмерно жёсткие | Упростить ограничения и убрать устаревшие указания, которые мешают выполнению задачи |
Итеративный подход
Настройку агента рекомендуется начинать с минимально необходимого набора инструкций: основного промпта, нужных слотов, документов базы знаний и шагов сценария. После тестирования на реальных диалогах изменения следует вносить в тот канал, который наиболее точно соответствует обнаруженной проблеме.
Не все проблемы должны решаться через основной промпт. Для разных задач предназначены разные механизмы: описания полей для извлечения данных, шаги сценария для управления поведением, Изменить контекст сценария для долгоживущего контекста, сигналы для автоматического обнаружения состояний, а база знаний — для справочной информации.
После каждого изменения важно проверять дублирование инструкций, противоречия между разными каналами настройки и влияние изменений на другие сценарии работы агента.