Задачи агента
Цель модуля: задать машинно-проверяемые задачи, чтобы агент не переспрашивал то, что уже получил.

Задачи агента (Качество и интеграции → Задачи агента). Две задачи учебного агента: «Визит подтверждён» (обязательная) и «SMS отправлено» — необязательная, доступна только после первой.
Показать панель целиком
Показать панель целиком

{{confirm_text}} != "". Отметку ставит код, а не модель: модель состояние задач только читает и никогда в него не пишет. Отсюда свойства, которых не даёт промпт:
- закрытую задачу агент не переспрашивает — сводка выполненного уходит в хвост промпта и обновляется на каждом ходу, поэтому из памяти не выпадает;
- задачу можно сделать пересматриваемой — клиент передумал, условие отмены сработало, задача снова открыта;
- предусловия задают зависимость: отправлять SMS-напоминание имеет смысл только после подтверждения визита;
- в формулах переходов доступен предикат
goals_completed()— «всё главное получено, можно прощаться».
Две вещи, которые часто спрашивают. Первая: сводка не попадает в расшифровку разговора — в записи звонка вы увидите только реальные реплики. Вторая: дополнительных обращений к языковой модели механизм не делает, на задержку звонка он не влияет. И ещё: дописывать сводку руками в промпты узлов не нужно — она подмешивается сама, а рукописная копия быстро разъедется с настройками.
Как задаются условия
Условие выполнения и Условие отмены собираются тем же конструктором условий, что работает на переходах: выбираете переменную, операцию и значение, а карточки складываются в выражение. Условие можно и править текстом — кнопка «Править текстом». Отдельной карточкой добавляется проверка «Узел пройден» (кнопка «+ Добавить пройденный узел»): узел выбирается из списка. Это единственное значение в условии задачи, которое автору негде подсмотреть, — поэтому оно выбирается из списка, а не вводится руками. Через мгновение после правки под условием появляется «Проверка…», затем «Условие разобрано» или «Условие некорректно» с причиной. Формулировка задачи — поле «Формулировка факта» — это утверждение о факте («личность подтверждена»), а не поручение («подтвердить личность»): текст уходит агенту, и текст-задание он начинает зачитывать вслух — «так, мне ещё нужно уточнить причину неплатежа». Формулировки стоит вычитывать на тестовых звонках с тем же вниманием, с каким вы вычитываете реплики агента.Шпаргалка по условиям
Регистр в сравнениях не учитывается:
"Да" и "да" — одно и то же. Выражения со скобками и со смесью AND и OR правятся только текстом — карточки такую форму не показывают.
Откуда берутся значения полей
Это главный практический вопрос настройки. Источников три:- Извлечение из разговора — то, что агент выясняет у человека: имя, дата, причина, ответ на вопрос. В свободном режиме извлечение идёт на каждом ходу, в жёстком сценарии — только на шагах, где оно настроено.
- Результаты обращений к вашим системам — у каждого запроса автоматически есть
{{имя}}_success,{{имя}}_status,{{имя}}_errorплюс поля, которые вы назначили из ответа. Полезный побочный эффект: если тот же запрос повторить и он вернёт неуспех, задача сама перестанет быть закрытой — отдельное условие отмены для этого не нужно. - Данные, известные до звонка — переменные звонка и кампании: имя из файла контактов, сумма долга, номер договора.
Задержка ровно в одну реплику. Состояние задач пересчитывается один раз в конце каждого хода, поэтому задача, закрытая ответом на текущей реплике, попадает в сводку и в признак
goals_completed() начиная со следующего хода. Это нормально, а не сбой.Задачу с неразбираемым условием черновик сохранит — но заблокирует публикацию агента и тестовый звонок. То есть недописанное условие не мешает отложить работу до завтра, но и незамеченным на прод не уедет.
Что видно в истории звонка
Раздел История → карточка звонка → вкладка «Транскрипт» с включённой галочкой «Отображать системные события» (она есть у администратора и разработчика). В хронологии видны три события: Задача закрыта (видно, на какой реплике), Отметка задачи снята (с причиной — сработало условие отмены, условие выполнения перестало быть истинным или отозвано предусловие) и Ошибка условия задачи. Если условие сломалось уже во время звонка — например, переменную переименовали, — звонок не прерывается: задача считается незакрытой, предупреждение пишется один раз, разговор идёт нормально. Подробнее о карточке — Детали звонка.Признак «всё выяснено» ≠ успешность звонка
Признакgoals_completed() поднимается, когда закрыты все задачи, отмеченные обязательными — необязательные его не удерживают. Звонок при этом не завершается сам: разговор редко заканчивается на последней галочке, человек ещё прощается и переспрашивает срок. Куда вести признак, решаете вы — в блок прощания, к переводу на оператора, к финальному подтверждению.
Оценка успешности звонка из пост-аналитики — та, что попадает в «Цель достигнута» кампании, — считается независимо и означает другое: «всё запланированное выяснено» против «звонок успешен по вашему критерию». В записи видны оба.
Чего задачи не делают
- Не работают у агентов на моделях «речь-в-речь» (realtime) — такие агенты не заполняют переменные по ходу разговора, а без них проверять нечего. Переключатель включить можно, эффекта не будет.
- Не заменяют обязательные раскрытия. Уведомление о записи, идентификация до обсуждения долга, а на профиле
us_tcpa— сообщение, что звонит ИИ-агент, — это не задачи: задача подсказывает агенту, а подсказку можно проигнорировать. Там, где произнести что-то обязательно, нужен жёсткий маршрут в сценарии. - Не навязывают порядок — только предусловия, и недоступная задача агенту не показывается вообще, чтобы он не поднял заблокированную тему раньше времени. При этом ответ, данный заранее, не теряется: значение сохранится, и задача закроется в момент выполнения предусловия.
- В жёстком сценарии задача на переменную, которую сценарий нигде не заполняет, не закроется — у свободного режима такого ограничения нет.
- Задачи живут на агенте и версионируются вместе с ним.