> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Чек-листы и экзамен
> Что проверяют перед публикацией агента и запуском кампании, типовые ошибки и шпаргалка терминов.
# Чек-листы, грабли, экзамен
**Цель:** закрепить курс собственным агентом, прошедшим оба чек-листа.
Эту страницу держите под рукой в работе — она про то, что проверяют перед каждой публикацией и каждым запуском.
## Перед публикацией агента
* Панель **Проверка** — без ошибок; каждое предупреждение осознано, а не «пусть будет».
* У каждого узла Function и Transfer есть маршрут неуспеха.
* Ни один узел не тупик: из каждого есть выход или он терминальный (End/Transfer).
* Глобальные узлы: условие срабатывания различимо, возврат в сценарий включён.
* Все `{{переменные}}` в репликах реально заполняются — из кампании, API или узлов.
* Прощание в End не перебивается (кроме осознанного «перезвоню позже»).
* Модель классификатора — быстрая; окно истории не раздуто.
* Голос: язык STT и TTS соответствуют языку клиентов, включён резервный TTS.
* Таймеры: таймер ответа короче порога завершения по тишине.
* Чат-тест: счастливый путь + все ветки + молчание. Голосовой тест: минимум один звонок.
* Пост-аналитика включена, критерий успеха сформулирован понятно человеку.
* Запись и срок хранения выставлены по договорённости с юристами.
## Перед запуском кампании
* Агент опубликован, и в кампании выбрана именно опубликованная версия.
* Транк проверен кнопкой «Позвонить»; разрешённые направления ограничены префиксом.
* Файл контактов: отчёт импорта прочитан, отклонённые строки объяснимы, дубли обработаны.
* Все переменные агента имеют колонки в файле (красная строка в карточке — пусто).
* Рабочие часы заданы; включён пояс контакта, если база по разным городам.
* Правила повторов: по постоянным отказам повтора нет, по «нет ответа» — не больше 2–3.
* AMD проверен живым звонком: и с ответом человека, и с уходом в голосовую почту.
* Реестр «Не звонить» пополнен из предыдущих кампаний.
* Первый запуск — 20–30 контактов, затем разбор 5 звонков в Истории и только потом массовый обзвон.
* Вебхуки указывают на рабочий адрес CRM, тестовые события выключены.
## Семь типовых ошибок новичка
| Симптом | Причина | Лечение |
| --------------------------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------- |
| Агент «не слышит» правильный ответ и переспрашивает | Два похожих промпт-условия на одном узле | Переформулировать различимо или свести к одному переходу |
| Диалог ушёл в неожиданную ветку | Формула стоит ниже общего условия | Перетащить специальные случаи выше общих |
| Клиент слышит тишину секунд пять | Function без реплики-филлера или три немых узла подряд | Добавить «Секунду, проверяю…», убрать лишние немые узлы |
| Агент называет чужое имя или пустую дату | В файле контактов нет колонки под переменную | Проверить таблицу переменных в карточке кампании |
| Прощание обрывается на полуслове | В End включено перебивание | Снять «Разрешить перебивание» у End |
| Разговор длится 20 минут | Нет потолка длительности и завершения по тишине | Выставить лимиты в «Управлении звонком» |
| Правки не влияют на боевые звонки | Черновик сохранён, но не опубликован | Опубликовать; проверить бейдж «Есть неопубликованные изменения» |
**Практический экзамен**
Соберите своего агента для реальной задачи вашего отдела — и предъявите его на разборе. Требования: не меньше 8 узлов; используются минимум 5 типов узлов; есть узел Function (можно на заглушке) с обработкой неуспеха; есть глобальный узел с возвратом; есть перевод на человека; заданы цели и критерий успеха; настроены голос и таймеры звонка; агент опубликован; в Истории лежит минимум один разговор, разобранный по трейсу.
На разбор принесите: ссылку на агента, один разговор из Истории и ответ на вопрос «что сломается, если клиент замолчит на середине разговора».
## Шпаргалка терминов
| Термин | Что это на практике |
| --------------------- | ------------------------------------------------------------------------------------------------------- |
| **Агент** | Один сценарий разговора целиком: граф + настройки + версии. |
| **Узел / нода** | Один шаг разговора. Говорит только Conversation. |
| **Переход** | Правило выхода из узла: Always, формула, промпт, Default, таймер. |
| **Классификатор** | Быстрая модель, которая выбирает переход на каждом ходу. |
| **Переменные звонка** | Память разговора: приходят снаружи, извлекаются, вычисляются. |
| **Глобальный узел** | Узел, достижимый из любого места, с возвратом в сценарий. |
| **Компонент** | Переиспользуемый мини-флоу; при публикации разворачивается в узлы. |
| **Черновик / версия** | Черновик — то, что вы правите. Версия — то, по чему идут звонки. |
| **Транк / маршрут** | Транк — соединение с оператором; маршрут — номер + агент (входящий) или caller ID + агенты (исходящий). |
| **Кампания** | Список контактов + агент + скорость + правила повторов. |
| **Пост-аналитика** | Разбор разговора после звонка: резюме, тональность, ваши поля, успешность. |
| **Наблюдатель** | Фоновый детектор нарушения правил + реакция на него. |
| **AMD** | Детекция автоответчика на исходящих звонках. |
**Куда идти дальше**
За рамками курса осталось намеренно: узел **MCP** (детерминированный вызов инструмента внешнего MCP-сервера), **Realtime-режим** (speech-to-speech вместо каскада STT-LLM-TTS), **flex-режим** переходов, **Web SDK** для звонка с сайта и **табличные отчёты**. Всё это надстройки над тем, что вы уже умеете: сначала соберите и запустите обычного каскадного агента.