Перейти к основному содержанию

Задачи агента

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

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

Окно «Задачи агента» с двумя задачами
Проблема, которую это решает, звучит так: агент помнит разговор не целиком, а последними репликами. На длинном звонке ранняя реплика, где человек уже назвал имя, из этой памяти выпадает — и агент спрашивает второй раз. Просьба «не переспрашивай» в промпте тут не помогает: он не забывает правило, он забывает факт. Задача — это факт разговора, выраженный условием по переменным: {{confirm_text}} != "". Отметку ставит код, а не модель: модель состояние задач только читает и никогда в него не пишет. Отсюда свойства, которых не даёт промпт:
  • закрытую задачу агент не переспрашивает — сводка выполненного уходит в хвост промпта и обновляется на каждом ходу, поэтому из памяти не выпадает;
  • задачу можно сделать пересматриваемой — клиент передумал, условие отмены сработало, задача снова открыта;
  • предусловия задают зависимость: отправлять SMS-напоминание имеет смысл только после подтверждения визита;
  • в формулах переходов доступен предикат goals_completed() — «всё главное получено, можно прощаться».
Задачи настраиваются в настройках агента: Качество и интеграции → Задачи агента. Первое действие в разделе — переключатель «Отслеживать задачи агента» в его шапке. Пока он выключен или список пуст, механизм выключен целиком и на поведение агента не влияет никак. Правки попадают в черновик по кнопке «Сохранить» окна.
Задачи агента — не «Цель достигнута». Показатель «Цель достигнута» в статистике кампании и на дашборде — это оценка пост-аналитики после звонка: модель решает, успешен ли звонок по критерию успеха агента (модуль 18). Задачи агента работают во время звонка, отмечаются кодом по условию и на этот показатель не влияют.
Две вещи, которые часто спрашивают. Первая: сводка не попадает в расшифровку разговора — в записи звонка вы увидите только реальные реплики. Вторая: дополнительных обращений к языковой модели механизм не делает, на задержку звонка он не влияет. И ещё: дописывать сводку руками в промпты узлов не нужно — она подмешивается сама, а рукописная копия быстро разъедется с настройками.

Как задаются условия

Условие выполнения и Условие отмены собираются тем же конструктором условий, что работает на переходах: выбираете переменную, операцию и значение, а карточки складываются в выражение. Условие можно и править текстом — кнопка «Править текстом». Отдельной карточкой добавляется проверка «Узел пройден» (кнопка «+ Добавить пройденный узел»): узел выбирается из списка. Это единственное значение в условии задачи, которое автору негде подсмотреть, — поэтому оно выбирается из списка, а не вводится руками. Через мгновение после правки под условием появляется «Проверка…», затем «Условие разобрано» или «Условие некорректно» с причиной. Формулировка задачи — поле «Формулировка факта» — это утверждение о факте («личность подтверждена»), а не поручение («подтвердить личность»): текст уходит агенту, и текст-задание он начинает зачитывать вслух — «так, мне ещё нужно уточнить причину неплатежа». Формулировки стоит вычитывать на тестовых звонках с тем же вниманием, с каким вы вычитываете реплики агента.
Совет: язык формулировки. Пишите формулировку факта на языке, на котором работает агент. Для русскоязычного агента — «Клиент подтвердил визит или выбрал новое время»; для англоязычного агента под профилем США (us_tcpa) — “The customer confirmed the appointment or picked a new time”.

Шпаргалка по условиям

Регистр в сравнениях не учитывается: "Да" и "да" — одно и то же. Выражения со скобками и со смесью AND и OR правятся только текстом — карточки такую форму не показывают.
Совет: значения на языке разговора. Если поле заполняется из ответа клиента, сравнивайте его с теми значениями, которые реально приходят в звонках. Для двуязычного агента проверяйте оба варианта: {{consent}} == "да" OR {{consent}} == "yes"; для англоязычного агента (us_tcpa) — {{consent}} == "yes", {{intent}} CONTAINS pay.

Откуда берутся значения полей

Это главный практический вопрос настройки. Источников три:
  1. Извлечение из разговора — то, что агент выясняет у человека: имя, дата, причина, ответ на вопрос. В свободном режиме извлечение идёт на каждом ходу, в жёстком сценарии — только на шагах, где оно настроено.
  2. Результаты обращений к вашим системам — у каждого запроса автоматически есть {{имя}}_success, {{имя}}_status, {{имя}}_error плюс поля, которые вы назначили из ответа. Полезный побочный эффект: если тот же запрос повторить и он вернёт неуспех, задача сама перестанет быть закрытой — отдельное условие отмены для этого не нужно.
  3. Данные, известные до звонка — переменные звонка и кампании: имя из файла контактов, сумма долга, номер договора.
Задержка ровно в одну реплику. Состояние задач пересчитывается один раз в конце каждого хода, поэтому задача, закрытая ответом на текущей реплике, попадает в сводку и в признак goals_completed() начиная со следующего хода. Это нормально, а не сбой.
Грабли: задача по переменной, которую никто не заполняетЕсли переменная условия не заполняется ни одним узлом, задача не закроется никогда — валидация об этом предупреждает, но не запрещает: переменная может законно приходить из кампании или из API. Проверьте, что она действительно приходит.
Задачу с неразбираемым условием черновик сохранит — но заблокирует публикацию агента и тестовый звонок. То есть недописанное условие не мешает отложить работу до завтра, но и незамеченным на прод не уедет.

Что видно в истории звонка

Раздел История → карточка звонка → вкладка «Транскрипт» с включённой галочкой «Отображать системные события» (она есть у администратора и разработчика). В хронологии видны три события: Задача закрыта (видно, на какой реплике), Отметка задачи снята (с причиной — сработало условие отмены, условие выполнения перестало быть истинным или отозвано предусловие) и Ошибка условия задачи. Если условие сломалось уже во время звонка — например, переменную переименовали, — звонок не прерывается: задача считается незакрытой, предупреждение пишется один раз, разговор идёт нормально. Подробнее о карточке — Детали звонка.

Признак «всё выяснено» ≠ успешность звонка

Признак goals_completed() поднимается, когда закрыты все задачи, отмеченные обязательными — необязательные его не удерживают. Звонок при этом не завершается сам: разговор редко заканчивается на последней галочке, человек ещё прощается и переспрашивает срок. Куда вести признак, решаете вы — в блок прощания, к переводу на оператора, к финальному подтверждению. Оценка успешности звонка из пост-аналитики — та, что попадает в «Цель достигнута» кампании, — считается независимо и означает другое: «всё запланированное выяснено» против «звонок успешен по вашему критерию». В записи видны оба.

Чего задачи не делают

  • Не работают у агентов на моделях «речь-в-речь» (realtime) — такие агенты не заполняют переменные по ходу разговора, а без них проверять нечего. Переключатель включить можно, эффекта не будет.
  • Не заменяют обязательные раскрытия. Уведомление о записи, идентификация до обсуждения долга, а на профиле us_tcpa — сообщение, что звонит ИИ-агент, — это не задачи: задача подсказывает агенту, а подсказку можно проигнорировать. Там, где произнести что-то обязательно, нужен жёсткий маршрут в сценарии.
  • Не навязывают порядок — только предусловия, и недоступная задача агенту не показывается вообще, чтобы он не поднял заблокированную тему раньше времени. При этом ответ, данный заранее, не теряется: значение сохранится, и задача закроется в момент выполнения предусловия.
  • В жёстком сценарии задача на переменную, которую сценарий нигде не заполняет, не закроется — у свободного режима такого ограничения нет.
  • Задачи живут на агенте и версионируются вместе с ним.
Полная справка по полям задачи и по блокирующим проверкам — на странице Задачи агента.