AI-агенты¶

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

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

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

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

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

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

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

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

LLM-модель¶

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

• Провайдер и версия модели (OpenAI, OpenRouter и др.)
• Temperature и дополнительные параметры модели

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

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

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

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

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

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

Голос (TTS)¶

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

• Провайдер TTS (ElevenLabs, Azure Speech, Minimax и др.)
• Выбор голоса и его параметры
• Регулировка скорости
• Тип и громкость фонового звука

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

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

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

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

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

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

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

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

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

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

Публикация¶

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

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

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

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