Настройка

Ждут решения

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

«Ждут решения» — страница команды, на которой оператор принимает решения. Сообщения, на которые бот ответил сам, сюда не попадают: тикет появляется только тогда, когда нужен человек.

1. Что происходит с сообщением

  1. Сообщение попадает в разговор: ключ разговора — канал и чат; разговор закрывается, если в нём тихо дольше 4 часов (настройка conversationIdleHours).
  2. Риск оценивают два слоя: правила (L1) и классификатор (L2) (Триаж и риск-движок).
  3. Лид команды решает: ответить самому, поручить исполнителю или позвать человека; исполнитель или лид готовит ответ.
  4. Ответ проходит проверки перед отправкой.
  5. Нет причины удерживать — ответ уходит в канал, тикета нет; он виден на странице «Разговоры». Есть причина — создаётся тикет со статусом waiting_operator, а человек получает в канале: «Запрос принят и передан оператору на проверку. Ответим в течение нескольких минут.»

Пока тикет ждёт, новые сообщения этого разговора попадают в тот же тикет.

2. Причины удержания

Причину показывает блок «Что это проверило» в тикете и поле holdReason:

Что написаноЧто значитЧто делать
«Контур команды: …»модель агента внешняя, а контур команды закрытcradle teams update <slug> --contour cloud или локальная модель (Ключи и модели)
«Проверка ответа не пройдена — автоответ задержан»не прошла проверка черновика («Цитаты», «Гигиена ответа»); детали — в блоке «Проверки ответа»поправить текст; отправить можно и несмотря на сбой — решение попадёт в журнал аудита
«Уровень риска yellow (или red) — требуется решение оператора.»сработали правила или классификаторрешить; правила настраиваются на вкладке команды «Triage и риски» (обзор — страница «Безопасность»)
«Классификатор рисков (L2) не отработал, вердикт опущен до L1 …»у колыбели нет модели для классификатора или она вернула ошибкуКлючи и модели
«Черновик не подтверждён источниками (strict grounding) — отправка задержана.»у агента режим Strict, а в ответе нет подтвержденияпроверить базу знаний (Базы знаний) или ответить вручную
«Агент не сформировал черновик ответа.»нет модели у агента или она не ответиламодель агента; ответить вручную
lead_escalationлид выбрал «нужен человек»ответить вручную
tool_approvalвызов инструмента ждёт одобренияраздел 4
task_ci_failedPR внешнего исполнителя красный и после возвращенияВнешний кодовый агент

3. Решите тикет

В консоли: страница команды → Ждут решения (рядом число ожидающих). Кнопки «В очереди», «Отклонены», «Все» и селекторы «Любой риск», «Все каналы», «Все лиды» сужают список. Откройте тикет: слева — сообщение и путь по команде, справа — блок «Что это проверило» (слой 1 — правила, слой 2 — классификатор, итог), «Проверки ответа» и поле ответа.

КнопкаЧто делает
Approve & sendотправляет черновик агента как есть
Edit & sendпоявляется, когда вы изменили текст: отправляет ваш вариант
Send replyкогда черновика нет: отправляет ответ, который вы написали вручную
Reassignдругой агент перегенерирует черновик (окно «Переназначить агента»)
Rejectокно «Отклонить тикет» с необязательной причиной: ответ в канал не уходит, статус rejected

Кнопка Разговор открывает весь разговор. Ответ оператора уходит в тот же канал и записывается в разговор как сообщение оператора.

Список и просмотр тикетов — командами:

cradle tickets list --status waiting_operator
cradle tickets show <ticket-id>

Команды cradle tickets approve и cradle tickets reject в версии 0.9.2 отвечают not implemented. Фильтр --status принимает точный статус: waiting_operator, approved_sent, rejected, error.

Как проверить. Тикет ушёл из «В очереди», счётчик уменьшился, статус — approved_sent; ответ пришёл в канал.

Если нет.

  • Статус error — не удалось отправить в канал (например, он остановлен): включите канал (Каналы) и нажмите Approve & send ещё раз.
  • «ticket already handled» — тикет уже решил другой оператор.

4. Одобрение вызова инструмента

Тикет с причиной tool_approval создаётся, когда агент хочет вызвать необратимый инструмент или внешний кодовый агент (code.dispatch; каждый такой запуск ждёт человека). Черновика у него нет. Одобрение выдаёт разрешение на вызов от вашего имени и продолжает задачу исполнителя; отклонение завершает задачу ошибкой, и ничего не запускается.

В консоли это те же кнопки на странице тикета. Тикет показывает исходное сообщение, но не аргументы вызова.

В консоли 0.9.2 кнопка Send reply у такого тикета активна, только когда в поле ответа есть любой текст: черновика нет, а поле пустое. Введите в него любой текст и нажмите кнопку — сервер для tool_approval текст не использует, он выдаёт одобрение. Reject работает без текста.

Как проверить. Статус задачи в разговоре сменился: исполнитель начал работу (для внешнего агента — сообщение «Задача отправлена исполнителю …»).

Если нет. Сообщение «Не получилось: …» в разговоре называет причину — например, GitHub отверг запуск workflow (Внешний кодовый агент).

5. Разговоры

Страница Разговоры показывает всё, что сказано ботам команды: фильтры «Все», «Открытые», «Закрытые», каналы, поиск по тексту. В разговоре: «Стенограмма», «Резюме» (появляется после закрытия), «Задачи» и «Тикеты». Тикет у разговора есть только если понадобился человек: «Тикетов нет — всё, что нужно, ушло ботом».

Как проверить. Ваше тестовое сообщение найдено поиском по тексту.

Если нет. «Разговоров пока нет» — сообщение не дошло до канала или попало в другую команду (Каналы).