Ваш первый агент

Этот туториал проведёт вас по созданию, настройке и тестированию первого голосового AI-агента. К концу у вас будет рабочий агент, отвечающий на вопросы о вашем бизнесе.

Что мы построим

Голосового агента, который:

• Профессионально приветствует звонящих
• Отвечает на вопросы по вашим бизнес-данным
• Сообщает часы работы и контакты
• Знает, когда передать человеку

Время: 15–20 минут

---

Предварительные требования

Прежде чем начать:

• Создан аккаунт Hanc.AI (Настройка аккаунта)
• Вы вошли в платформу
• Базовая информация о бизнесе под рукой

---

Шаг 1: Создайте нового агента

Два пути создания агента: на основе шаблона (рекомендуется новичкам) или с нуля.

Путь A: на основе шаблона (рекомендуется)

Template Roles предоставляют предустановленные конфигурации для быстрого старта. Hanc.AI предлагает 24 готовых шаблона ролей в двух категориях.

1.1 Перейдите в Voice Agents

1. Нажмите «Voice Agents» в боковой панели
2. Если это первый раз, онбординг-тур проведёт вас по интерфейсу

1.2 Начните создание агента

Нажмите «Create Voice Agent». Появится модалка с двумя опциями:

• Start from Scratch — создаёт чистого агента, который настраивается вручную (см. Путь B ниже)
• Template Roles — 24 шаблона ролей в двух категориях

1.3 Просмотрите шаблоны ролей

Template Roles разделены на две категории:

Для клиентов (14 ролей):

Шаблон	Лучше всего для
Sales Agent	Звонки продаж, питч, закрытие сделок
Receptionist	Приветствие, маршрутизация, общие запросы
Consultant	Discovery-звонки, оценка потребностей, консультирование
Support Agent	Поддержка клиентов, диагностика, решение проблем
Order Agent	Оформление, трекинг, изменение заказов
Call Router	Направление звонящих в нужный отдел или к нужному человеку
Reminder Agent	Напоминания о визите, фоллоу-апы, уведомления
Feedback Agent	Сбор обратной связи и опросы
Collection Agent	Напоминания об оплате, фоллоу-апы по счетам
Lead Qualifier	Квалификация входящих лидов, сбор данных о клиенте
Guide	Пошаговые инструкции, онбординг, walkthrough
Promoter	Узнаваемость продукта, кампании, верх воронки
Auto-Answerer	Автоприём звонков, базовая информация
Presenter	Презентации продукта или услуги, демо

Для сотрудников (10 ролей):

Шаблон	Лучше всего для
Secretary	Управление внутренними звонками, расписание, приём сообщений
Recruiter	Скрининг кандидатов, назначение интервью
Onboarder	Онбординг новых сотрудников, ориентация
Coordinator	Координация команды, расписание встреч
Controller	Мониторинг процессов, статусы, проверки соответствия
Internal Helpdesk	IT-поддержка, внутренний FAQ, помощь сотрудникам
Data Collector	Сбор структурированных данных от членов команды
Approval Agent	Маршрутизация одобрений, сбор подписей
Procurement Agent	Запросы на закупки, запросы поставщикам
Dispatcher	Назначение задач, аллокация ресурсов, диспетчеризация

Для этого туториала: выберите любой подходящий шаблон.

Зачем использовать Template Role?

Template Roles включают готовые промпты, приветствия и протоколы разговора, оптимизированные под конкретные роли. После создания всё можно настроить под себя.

1.4 Просмотр деталей шаблона

Кликните по карточке шаблона — откроется детальный вид:

• Описание роли и того, что делает агент
• Преимущества использования
• Возможности агента
• Выбор языка — сначала вы выбираете язык (например, English, Deutsch), затем региональный вариант (например, United States, Austria, Switzerland) и подходящий голос
• Скачать как Word-документ — экспортирует вопросы Setup Wizard в .docx на выбранном языке, чтобы команда могла заполнить оффлайн. После заполнения тот же Guided Setup wizard может прочитать документ и автозаполнить все совпадающие поля — см. Заполнение через Word-документ ниже

Языковое покрытие

Каждый шаблон поставляется в 20 поддерживаемых языках с native-качеством промптов и голосами под каждый. Receptionist на немецком использует настоящую немецкую базу, а не перевод с английского.

Заполнение через Word-документ

Если удобнее собирать информацию оффлайн (или распределить работу между коллегами), используйте Word-путь:

1. Нажмите Download as Word document в модалке роли — получите .docx под выбранную роль и язык.
2. Заполните разделы, где есть ответы. Что не знаете — пропустите.
3. Нажмите Guided Setup, чтобы открыть мастер для той же роли.
4. Внутри мастера нажмите Upload filled document и выберите файл. Мастер распарсит ответы и покажет подтверждение вроде «12 из 18 полей заполнены из документа».
5. Проверьте и подправьте автозаполненные поля, затем продолжайте мастер как обычно.

Документ можно перезагружать сколько угодно — каждый аплоад обновляет совпадающие поля свежими значениями из файла.

1.5 Выберите, как создавать

В детальном виде шаблона — две кнопки:

• Deploy Agent — мгновенно создаёт агента с дефолтами шаблона. Детали бизнеса можно заполнить позже через Setup Wizard. Самый быстрый старт.
• Guided Setup — пошаговый мастер для заполнения бизнес-деталей (название компании, услуги, контакты) перед созданием.

Какую кнопку выбрать?

Deploy Agent — если хотите сначала пощупать агента и настроить позже. Guided Setup — если бизнес-инфо под рукой и нужен более готовый агент.

1.6 Guided Setup (если выбрали)

Если нажали Guided Setup, мастер проведёт через заполнение специфичных для бизнеса деталей:

• Название компании, услуги, контакты
• Часы работы, адрес, цены
• Конкретные инструкции и политики

Важно: можно пропускать поля или целые разделы, которые не относятся к вам. Однако хотя бы один раздел должен быть полностью заполнен, прежде чем продолжить.

После завершения мастера агент создаётся со всеми заданными деталями.

Путь B: с нуля

Для полного контроля с самого начала:

1. Нажмите «Create Voice Agent»
2. Выберите «Start from Scratch»
3. Создаётся чистый агент с дефолтным промптом
4. На следующем шаге всё настраивается вручную

---

Шаг 2: После создания

После создания агента появится баннер успеха с предложенными следующими шагами. Онбординг-тур проведёт вас по вкладкам конфигурации, выделяя ключевые настройки и функции.

У вашего агента две дефолтные retrieval-переменные — Email и Phone — он сразу может собирать контактные данные. Можно настроить или удалить их на вкладке Actions.

Setup Wizard

Найдите светящуюся иконку волшебной палочки рядом с именем агента — это Setup Wizard. Помогает заполнить оставшиеся детали по разделам.

Как работает Setup Wizard:

• Прогресс показывается как «X/Y разделов завершено» — всегда видно, что осталось
• Каждый раздел — отдельная область конфигурации: Agent Configuration, Company Profile, Services, Specialists, Locations и т. д.
• Можно пропускать поля или целые разделы (минимум 1 поле на раздел)
• Идите по разделам в любом порядке в своём темпе

к сведению

Если вы использовали Deploy Agent, Setup Wizard — основной способ добавить бизнес-детали после создания. Если Guided Setup — часть разделов уже будет заполнена.

Важно

Ручное редактирование промпта или файлов базы знаний отключает Setup Wizard. Если это произошло, появится кнопка «Reset to Template» для восстановления.

Вкладки агента

Страница конфигурации агента включает:

Вкладка	Что содержит
Dashboard	Обзор активности и статистика
Model	Промпт, голос, язык и настройки AI-модели
Knowledge Base	Файлы и информация, используемая агентом
Settings	Настройки звонка, приветствие, ограничения длительности
Actions	Пост-звоночные действия (email, SMS, вебхуки)
Widgets	Настройка веб-виджета для встраивания на сайт

---

Шаг 3: Настройте параметры агента

3.1 Промпт

Промпт определяет личность, поведение и поток разговора агента.

Если использовали шаблон — промпт уже заполнен. Пересмотрите и адаптируйте под бизнес.

Если с нуля — напишите промпт:

## Роль
Вы — дружелюбный виртуальный ассистент [Название вашего бизнеса].
Помогаете клиентам с вопросами об услугах, часах работы и записях.

## Стиль общения
- Говорите ясно и кратко
- Будьте вежливы и профессиональны
- Короткие ответы (1–3 предложения, когда возможно)
- Один вопрос за раз

## Важные правила
1. Сообщайте только то, в чём уверены
2. Если не знаете — скажите «У меня нет этой информации, но я могу соединить вас с командой»
3. Никогда не выдумывайте цены, доступность или другие конкретные детали
4. Передавайте человеку, если клиент расстроен или вопрос сложный

Критическое правило

Всегда включайте инструкцию: «Никогда не выдумывайте информацию». Это предотвращает галлюцинации AI о вашем бизнесе.

3.2 База знаний

База знаний даёт агенту факты для ответов.

1. Откройте вкладку Knowledge Base в настройках агента
2. Создайте новую базу знаний или выберите существующую
3. Загрузите файлы с бизнес-информацией

Принимаемые форматы: .txt, .md, .docx, .pdf, .html, .csv

Что включить:

• Услуги и цены
• Часы работы и адрес
• Частые вопросы
• Политики (отмена, оплата и т. д.)
• Информацию о команде

Важно

Агент знает ТОЛЬКО то, что в базе знаний. Если информации нет — агент не сможет ответить. Добавляйте все важные детали.

3.3 Голос

Выберите голос под бренд:

• Выберите язык
• Просмотрите доступные голоса (м/ж, разные стили)
• Прослушайте перед выбором

3.4 Настройки звонка

Настройте поведение звонка:

• Первое сообщение (приветствие)
• Настройки языка
• Ограничения длительности

3.5 Tools

Добавьте инструменты, которые агент использует во время звонка:

• Google Calendar для записи на приём
• Кастомные API-интеграции

3.6 Actions

Настройте действия после звонка:

• Отправка email-резюме
• Отправка SMS-уведомлений
• Вызов вебхуков
• API-вызовы

3.7 Widget

Настройте веб-виджет:

• Внешний вид и цвета
• Позиция и поведение
• Кастомный брендинг

3.8 Сохраните

Нажмите «Save» или «Update».

---

Шаг 4: Протестируйте агента

Теперь увидим агента в деле!

4.1 Тест через виджет

1. Найдите агента в списке Voice Agents
2. Нажмите «Talk to agent» или кнопку теста
3. Разрешите доступ к микрофону
4. Начните говорить

4.2 Тест через телефонный номер

Если есть подключённый номер:

1. Назначьте агента на номер (в Phone Numbers)
2. Позвоните с любого телефона

4.3 Тестовые сценарии

Тест 1: базовое приветствие

• Дождитесь приветствия
• Скажите: «Здравствуйте»
• Агент должен ответить естественно

Тест 2: часы работы

• Скажите: «Какие у вас часы работы?»
• Агент должен сообщить часы из базы знаний

Тест 3: вопрос об услугах

• Скажите: «Какие услуги вы предлагаете?»
• Агент должен перечислить услуги

Тест 4: вопрос о цене

• Скажите: «Сколько стоит [ваша услуга]?»
• Агент должен назвать цену, если она в базе

Тест 5: неизвестный вопрос

• Скажите: «В чём смысл жизни?»
• Агент должен вежливо сказать, что у него нет такой информации

4.4 Завершите тест

Нажмите «End call» или закройте окно теста.

---

Шаг 5: Шлифуйте агента

По результатам теста улучшайте:

Частые проблемы и решения

Проблема	Решение
Агент много говорит	Добавить в промпт: «Держите ответы в 1–2 предложениях»
Слишком формально	Скорректировать тон: «Будьте дружелюбны и разговорны»
Не знает информацию	Проверить, есть ли она в базе знаний
Что-то выдумывает	Усилить в промпте: «НИКОГДА не выдумывайте»
Неправильный язык	Проверить настройку Language
Голос слишком быстрый/медленный	Скорректировать скорость

Итеративно улучшайте

1. Тест → выявить проблемы → скорректировать промпт/настройки → повторить
2. Добавляйте больше FAQ в базу по результатам тестов
3. Шлифуйте промпт по реальным разговорам

---

Шаг 6: Разверните агента (по желанию)

Когда тестирование удовлетворяет, развёртывайте:

Вариант A: подключить номер

1. Phone Numbers
2. Купите или импортируйте номер
3. Назначьте агента на номер
4. Звонки на этот номер обрабатывает ваш агент

Вариант B: виджет на сайте

1. Откройте настройки агента
2. Вкладка Widgets
3. Скопируйте embed-код
4. Вставьте на сайт

---

Чек-лист: готов ли агент?

Перед запуском проверьте:

• Приветствие чёткое и тёплое
• Промпт корректно описывает поведение
• В базе знаний верная информация
• Агент хорошо отвечает на частые вопросы
• Агент признаёт, когда что-то не знает
• Голос подходит бренду
• Корректно задан язык
• Тестовые звонки дают хорошие результаты

---

Дальше

Поздравляем! Вы создали первого голосового агента.

Продолжайте учиться:

1. Глубокое погружение в голосовых агентов — продвинутая конфигурация
2. Лучшие практики базы знаний — как делать БЗ лучше
3. Телефонные номера — подключить реальные номера
4. Template Roles — готовые промпты и конфигурации
5. Кампании — настройка исходящего обзвона

---

Решение проблем

Тестовый звонок не стартует

• Проверьте разрешения микрофона в браузере
• Попробуйте другой браузер
• Проверьте стабильность интернета

Агент не отвечает

• Подождите пару секунд — может быть задержка обработки
• Говорите чётко и не слишком быстро
• Проверьте, что агент не на паузе

Агент даёт неверную информацию

• Проверьте контент базы знаний
• Убедитесь, что БЗ подключена к агенту
• Пересмотрите промпт на противоречивые инструкции

Плохое качество голоса

• Проверьте интернет
• Попробуйте другой голос
• Уменьшите фоновый шум

---

Нужна помощь?

• Загляните в Гид по решению проблем
• Напишите на support@hanc.ai