Ваш первый агент
Это руководство проведёт вас через создание, настройку и тестирование первого голосового ИИ-агента. К концу у вас будет работающий агент, способный отвечать на вопросы о вашем бизнесе.
Что мы создадим
Голосового агента, который:
- Профессионально приветствует звонящих
- Отвечает на вопросы, используя информацию о вашем бизнесе
- Сообщает часы работы и контактные данные
- Знает, когда нужно перевести звонок на человека
Ориентировочное время: 15–20 минут
Предварительные требования
Перед началом убедитесь, что у вас есть:
- Созданный аккаунт Hanc.AI (Настройка аккаунта)
- Выполненный вход на платформу
- Готовая базовая информация о вашем бизнесе
Шаг 1: Создайте нового агента
Есть два пути создания агента: на основе шаблона (рекомендуется для начинающих) или с нуля.
Путь A: На основе шаблона (рекомендуется)
Template Roles предоставляют готовые конфигурации, которые позволяют быстро начать. Hanc.AI предлагает 24 готовых к использованию шаблона ролей в двух категориях.
1.1 Перейдите в Voice Agents
- Нажмите «Voice Agents» в левой боковой панели
- Если вы делаете это впервые, вас шаг за шагом проведёт по интерфейсу ознакомительный тур
1.2 Начните создание агента
Нажмите кнопку «Create Voice Agent». Появится окно с двумя вариантами:
- Start from Scratch — создаёт пустого агента, которого вы настраиваете вручную (см. Путь B ниже)
- Template Roles — 24 шаблона ролей, распределённых по двум категориям
Также можно собрать агента с помощью Hanc Studio — опишите, что вам нужно, и он соберёт готового агента (роль, workflow, базу знаний и интеграции) за вас.
1.3 Просмотрите Template Roles
Template Roles распределены по двум категориям:
Для клиентов (14 ролей):
| Шаблон | Лучше всего подходит для |
|---|---|
| Sales Agent | Продажи, презентация, закрытие сделок |
| Receptionist | Приветствие звонящих, маршрутизация, общие вопросы |
| Consultant | Ознакомительные звонки, выявление потребностей, консультирование |
| Support Agent | Клиентская поддержка, диагностика, решение проблем |
| Order Agent | Оформление, отслеживание и изменение заказов |
| Call Router | Направление звонящих в нужный отдел или к нужному человеку |
| Reminder Agent | Напоминания о записях, повторные обращения, уведомления |
| Feedback Agent | Сбор отзывов клиентов и опросы |
| Collection Agent | Напоминания об оплате, работа со счетами |
| Lead Qualifier | Квалификация входящих лидов, сбор информации о потенциальных клиентах |
| Guide | Пошаговые инструкции, онбординг, сопровождение |
| Promoter | Знакомство с продуктом, кампании, вовлечение на верхних этапах воронки |
| Auto-Answerer | Автоматический приём звонков, выдача базовой информации |
| Presenter | Презентации продуктов или услуг, демонстрации |
Для сотрудников (10 ролей):
| Шаблон | Лучше всего подходит для |
|---|---|
| Secretary | Управление внутренними звонками, планирование, приём сообщений |
| Recruiter | Скрининг кандидатов, планирование собеседований |
| Onboarder | Онбординг новых сотрудников, ознакомление |
| Coordinator | Координация команды, планирование встреч |
| Controller | Мониторинг процессов, обновление статусов, проверки на соответствие |
| Internal Helpdesk | ИТ-поддержка, внутренний FAQ, помощь сотрудникам |
| Data Collector | Сбор структурированных данных от участников команды |
| Approval Agent | Маршрутизация согласований, сбор подтверждений |
| Procurement Agent | Заявки на закупку, запросы к поставщикам |
| Dispatcher | Назначение задач, распределение ресурсов, диспетчеризация |
Для этого руководства: выберите любой шаблон, соответствующий вашему сценарию использования.
Template Roles включают заранее написанные промпты, приветственные сообщения и протоколы разговора, оптимизированные под конкретные роли. Всё можно настроить после создания.
1.4 Просмотрите детали шаблона
Нажмите на карточку любого шаблона, чтобы открыть подробное представление, показывающее:
- Описание роли и того, что делает агент
- Преимущества использования этого шаблона
- Возможности, которые будут у агента
- Выбор языка — сначала вы выбираете язык (например, English, Deutsch), затем региональный вариант (например, United States, Austria, Switzerland) и соответствующий голос
- Скачать как документ Word — экспортирует вопросы мастера настройки в файл
.docxна выбранном вами языке, чтобы ваша команда могла заполнить его офлайн. После заполнения тот же мастер Guided Setup может считать документ обратно и автоматически заполнить все совпадающие поля — см. Заполнение через документ Word ниже
Каждый шаблон поставляется на 25 поддерживаемых языках с промптами нативного качества и вариантами голоса для каждого. Роль Receptionist на немецком использует настоящий немецкий оригинал, а не перевод английского шаблона.
Заполнение через документ Word
Если вы предпочитаете собирать информацию о бизнесе офлайн (или разделить работу между коллегами), используйте путь через документ Word:
- Нажмите Download as Word document в окне с деталями роли — вы получите файл
.docx, соответствующий выбранной роли и языку. - Заполните столько разделов, на сколько у вас есть ответы. То, что не знаете, пропустите.
- Нажмите Guided Setup, чтобы открыть мастер для той же роли.
- Внутри мастера нажмите Upload filled document и выберите файл. Мастер разбирает ваши ответы и показывает подтверждение вроде «12 из 18 полей заполнены из документа».
- Проверьте и при необходимости скорректируйте предзаполненные поля, затем продолжайте работу с мастером как обычно.
Документ можно загружать повторно в любое время — при каждой загрузке совпавшие поля обновляются актуальными значениями из вашего файла.
1.5 Выберите способ создания
Из подробного представления шаблона вам доступны две кнопки:
- Deploy Agent — мгновенно создаёт агента с настройками шаблона по умолчанию. Данные о вашем бизнесе можно заполнить позже с помощью мастера настройки. Это самый быстрый способ начать.
- Guided Setup — открывает пошаговый мастер, где вы заполняете данные о своём бизнесе (название компании, услуги, контактную информацию и т. д.) до создания агента.
Deploy Agent отлично подходит, если вы хотите сначала изучить агента, а настроить его позже. Guided Setup лучше, если у вас уже готова информация о бизнесе и вы хотите более полного агента с самого начала.
1.6 Guided Setup (если выбрали)
Если вы нажали Guided Setup, мастер проведёт вас через заполнение данных, специфичных для вашего бизнеса:
- Название компании, услуги, контактные данные
- Часы работы, местоположение, цены
- Особые инструкции и правила
Важно: вы можете пропускать поля или целые разделы, которые не относятся к вашему бизнесу. Однако прежде чем продолжить, необходимо полностью заполнить хотя бы один раздел.
После завершения работы с мастером ваш агент создаётся со всеми предоставленными вами данными.
Путь B: С нуля
Для полного контроля с самого начала:
- Нажмите «Create Voice Agent»
- Выберите «Start from Scratch»
- Создаётся пустой агент с промптом по умолчанию
- Всё вы настроите вручную на следующем шаге
Шаг 2: После создания
Как только ваш агент создан, вы увидите баннер об успехе с предлагаемыми следующими шагами. Ознакомительный тур проведёт вас по вкладкам настройки агента, подсвечивая ключевые параметры и функции.
Ваш агент поставляется с двумя переменными сбора данных по умолчанию — Email и Phone — так что он сразу может собирать контактную информацию у звонящих. Вы можете настроить или удалить их на вкладке Actions.
Мастер настройки
Найдите светящуюся иконку волшебной палочки рядом с именем вашего агента — это мастер настройки (Setup Wizard). Он помогает заполнять оставшиеся данные раздел за разделом.
Как работает мастер настройки:
- Прогресс отслеживается как «X/Y разделов завершено», поэтому вы всегда знаете, что осталось
- Каждый раздел охватывает свою область конфигурации: Agent Configuration, Company Profile, Services, Specialists, Locations и другие
- Вы можете пропускать поля или целые разделы, которые вам не нужны (минимум 1 поле на раздел)
- Проходите разделы в любом порядке в своём темпе
Если вы использовали Deploy Agent, мастер настройки — ваш основной способ добавить данные о бизнесе после создания. Если вы использовали Guided Setup, некоторые разделы уже будут заполнены.
Ручное редактирование промпта или файлов базы знаний отключает мастер настройки. Если это произойдёт, появится кнопка «Reset to Template», которая позволяет восстановить работу мастера.
Вкладки агента
Страница настройки вашего агента содержит следующие вкладки:
| Вкладка | Что содержит |
|---|---|
| Dashboard | Обзор активности агента и статистика |
| Model | Промпт, голос, язык и настройки ИИ-модели |
| Knowledge Base | Файлы и информация, которые агент использует для ответов на вопросы |
| Settings | Настройки звонка, первое сообщение, ограничения длительности звонка |
| Actions | Действия после звонка (email, SMS, вебхуки) |
| Widgets | Настройка веб-виджета для встраивания на ваш сайт |
Шаг 3: Настройте параметры агента
3.1 Промпт
Промпт определяет личность, поведение и логику разговора вашего агента.
Если вы использовали шаблон, промпт уже заполнен. Проверьте его и настройте под свой бизнес.
Если вы начали с нуля, напишите свой промпт:
## Role
You are a friendly virtual assistant for [Your Business Name].
You help customers with questions about our services, hours, and booking appointments.
## Communication Style
- Speak clearly and concisely
- Be polite and professional
- Keep responses short (1-3 sentences when possible)
- Ask one question at a time
## Important Rules
1. Only provide information you know for certain
2. If you don't know something, say "I don't have that information, but I can connect you with our team"
3. Never make up prices, availability, or other specific details
4. Transfer to a human if the customer is upset or has a complex issue
Всегда включайте инструкцию: «Never make up information» («Никогда не выдумывай информацию»). Это не даёт ИИ придумывать ложные сведения о вашем бизнесе.
3.2 База знаний
База знаний даёт вашему агенту факты, необходимые для ответов на вопросы.
- Перейдите на вкладку Knowledge Base в настройках агента
- Создайте новую базу знаний или выберите существующую
- Загрузите файлы с информацией о вашем бизнесе
Принимаемые форматы файлов: .txt, .md, .docx, .pdf, .html, .csv
Что включить:
- Услуги и цены
- Часы работы и местоположение
- Часто задаваемые вопросы
- Правила (отмена, оплата и т. д.)
- Информацию о команде
Агент знает ТОЛЬКО то, что есть в базе знаний. Если информация отсутствует, агент не сможет ответить на эти вопросы. Добавьте все важные детали.
3.3 Голос
Выберите голос, соответствующий вашему бренду:
- Выберите язык
- Просмотрите доступные голоса (мужские/женские, разные стили)
- Прослушайте голоса перед выбором
3.4 Настройки звонка
Настройте поведение звонка:
- Первое сообщение (приветствие, когда агент отвечает)
- Языковые настройки
- Ограничения длительности звонка
3.5 Tools
Добавьте инструменты, которые агент может использовать во время звонков:
- Google Calendar для записи на приём
- Пользовательские интеграции через API
3.6 Actions
Настройте действия после звонка, которые срабатывают по завершении разговора:
- Отправка email-сводок
- Отправка SMS-уведомлений
- Запуск вебхуков
- Вызовы API
3.7 Виджет
Настройте веб-виджет для встраивания на ваш сайт:
- Внешний вид и цвета
- Положение и поведение
- Собственный брендинг
3.8 Сохраните настройки
Нажмите «Save» или «Update», чтобы сохранить конфигурацию.
Шаг 4: Протестируйте агента
Теперь давайте посмотрим на вашего агента в действии!
4.1 Тест через веб-виджет
- Найдите своего агента в списке Voice Agents
- Нажмите «Talk to agent» или кнопку тестирования/звонка
- Разрешите доступ к микрофону в браузере
- Начните говорить
4.2 Тест через номер телефона
Если у вас подключён номер телефона:
- Назначьте агента на номер (в настройках Phone Numbers)
- Позвоните на номер с любого телефона
4.3 Сценарии тестирования
Тест 1: Базовое приветствие
- Дождитесь приветствия агента
- Скажите: «Здравствуйте»
- Агент должен ответить естественно
Тест 2: Часы работы
- Скажите: «Какие у вас часы работы?»
- Агент должен сообщить ваши часы работы из базы знаний
Тест 3: Вопрос об услугах
- Скажите: «Какие услуги вы предлагаете?»
- Агент должен перечислить ваши услуги
Тест 4: Вопрос о цене
- Скажите: «Сколько стоит [ваша услуга]?»
- Агент должен назвать цену, если она есть в базе знаний
Тест 5: Неизвестный вопрос
- Скажите: «В чём смысл жизни?»
- Агент должен вежливо сказать, что у него нет такой информации
4.4 Завершите тест
По окончании нажмите «End call» или закройте окно тестирования.
Шаг 5: Доработайте агента
По результатам тестирования вы можете захотеть улучшить:
Частые проблемы и решения
| Проблема | Решение |
|---|---|
| Агент слишком много говорит | Добавьте в промпт: «Keep responses to 1-2 sentences» |
| Агент слишком формален | Скорректируйте тон в промпте: «Be friendly and conversational» |
| Агент не знает информацию | Проверьте, что информация есть в базе знаний |
| Агент выдумывает | Подчеркните в промпте: «NEVER invent information» |
| Неправильный язык | Проверьте, что настройка Language соответствует вашим требованиям |
| Голос слишком быстрый/медленный | Скорректируйте настройки скорости голоса |
Итерируйте и улучшайте
- Тестируйте → выявляйте проблемы → корректируйте промпт/настройки → тестируйте снова
- Добавляйте больше FAQ в базу знаний на основе тестовых звонков
- Дорабатывайте промпт на основе реальных разговоров
Шаг 6: Разверните агента (необязательно)
Когда вы довольны результатами тестирования, можно развернуть агента:
Вариант A: Подключить номер телефона
- Перейдите в Phone Numbers
- Купите номер или импортируйте существующий
- Назначьте агента на номер
- Теперь звонки на этот номер обрабатывает ваш агент
Вариант B: Добавить виджет на сайт
- Перейдите в настройки агента
- Найдите вкладку Widgets
- Скопируйте код встраивания
- Добавьте его на свой сайт
Чек-лист: готов ли ваш агент?
Перед запуском проверьте:
- Первое сообщение понятное и приветливое
- Промпт корректно определяет поведение
- В базе знаний точная информация
- Агент хорошо справляется с частыми вопросами
- Агент признаёт, когда чего-то не знает
- Голос подходит вашему бренду
- Язык настроен правильно
- Тестовые звонки дают хорошие результаты
Что дальше?
Поздравляем! Вы создали своего первого голосового агента.
Продолжайте обучение:
- Подробно о голосовых агентах — расширенная настройка агента
- Лучшие практики базы знаний — создавайте более качественные базы знаний
- Номера телефонов — подключение реальных телефонных номеров
- Template Roles — готовые промпты и конфигурации
- Кампании — настройка кампаний исходящих звонков
Устранение неполадок
Агент не запускает тестовый звонок
- Проверьте разрешения браузера на доступ к микрофону
- Попробуйте другой браузер
- Убедитесь в стабильном интернет-соединении
Агент не отвечает
- Подождите несколько секунд — возможна задержка обработки
- Говорите чётко и не слишком быстро
- Проверьте, что агент не приостановлен/не отключён
Агент даёт неправильную информацию
- Убедитесь, что содержимое базы знаний корректно
- Проверьте, что база знаний подключена к агенту
- Проверьте промпт на противоречивые инструкции
Плохое качество голоса
- Проверьте интернет-соединение
- Попробуйте другой голос
- Уменьшите фоновый шум
Нужна помощь?
- Изучите Руководство по устранению неполадок
- Обратитесь на support@hanc.ai