AI-агенты

AI-агенты — основа Voxagent. Каждый агент — это настраиваемый голосовой ассистент, способный вести разговоры с пользователями в реальном времени.

Настройка агента

Основные параметры

• Название — имя агента (до 50 символов)
• Системный промпт — инструкции, определяющие поведение, личность и знания агента. Поддерживает динамические переменные в формате {{имя_переменной}}
• Temperature — контролирует случайность ответов LLM (0 = детерминированные, 1 = креативные)
• Лимит токенов — максимальное потребление токенов за разговор

Языки и локализация

Каждый агент поддерживает несколько языков. Для каждого языка настраивается:

• Первое сообщение — приветствие, которое агент произносит в начале разговора
• TTS-голос — голос и провайдер синтеза речи
• Скорость речи — множитель скорости воспроизведения
• Фоновый звук — звуковой фон во время разговора (тишина, офис, кофейня и т.д.)

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

LLM-модель

Выбор языковой модели, которая обеспечивает логику агента:

• LLM-провайдер и версия модели
• Temperature и дополнительные параметры модели

Распознавание речи (STT)

Настройка транскрибации речи пользователя:

• Модель и STT-провайдер
• Параметры, специфичные для модели

Детекция голосовой активности (VAD)

Управление детекцией речи пользователя:

• Выбор модели VAD
• Параметры чувствительности и таймингов
• Возможность отключить прерывания во время первого сообщения

Голос (TTS)

Настройка голоса агента для каждого языка:

• TTS-провайдер
• Выбор голоса и его параметры
• Регулировка скорости
• Тип и громкость фонового звука

Динамические переменные

Агенты поддерживают динамические переменные в системных промптах и первых сообщениях. Переменные задаются через OpenAPI-схему и подставляются при запуске.

Пример системного промпта:

Ты агент поддержки компании {{company_name}}.
Имя клиента — {{customer_name}}, номер заказа — {{order_id}}.

Переменные передаются через:

• API-вызов при диспатче
• URL-параметры (для виджета)
• Данные элемента кампании (для исходящих звонков)

Каждая переменная имеет:

• Имя
• Тип (string, number, boolean, integer)
• Описание
• Значение по умолчанию
• Флаг nullable

Инструменты агента

Агенты могут вызывать внешние API во время разговора. Подробнее в разделе Инструменты и интеграции.

Публикация

Агент может быть опубликован для предоставления доступа:

• Опубликованный агент — доступен по публичной ссылке для тестирования
• Виджет — встраивается на любой сайт
• Номер телефона — привязывается к входящей/исходящей телефонии
• API — запускается программно

Дублирование агента

Любой агент можно продублировать, создав копию со всеми настройками. Полезно для создания вариаций или шаблонов.