> ## 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.

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

> Настройка поведения и голоса агента HubTalk AI v4: с чего начать и где что лежит.

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

Настройки агента живут во вкладке **«Настройки»** в конструкторе. Откройте агента, перейдите на неё и настройте параметры, которые определяют обработку разговоров, речь агента, работу с базами знаний и управление звонками.

Настроек много, поэтому они разложены по отдельным страницам — список ниже. Здесь остаётся только то, что нужно решить первым.

## Режим Pipeline

Выберите, как агент будет обрабатывать разговоры:

* **STT-LLM-TTS pipeline** — настройте отдельно распознавание речи, языковую модель и синтез речи.
* **Realtime model** — используйте модель, которая обрабатывает речь в реальном времени по принципу speech-to-speech.

<img src="https://mintcdn.com/hubtalk/yYJS_d_pzapQzHCp/images/v4_settings_pipeline_mode.png?fit=max&auto=format&n=yYJS_d_pzapQzHCp&q=85&s=703856cbf4590e10ace5537f9608cb49" alt="Переключатель режима Pipeline: STT-LLM-TTS или Realtime model" width="1440" height="900" data-path="images/v4_settings_pipeline_mode.png" />

<Warning>
  **Это решение стоит принять до остальных настроек: часть из них в realtime-режиме не работает.** У такого агента нет отдельного шага синтеза и он не заполняет поля по ходу разговора, поэтому не действуют [цели разговора](/ru/v4/platform/agent-settings/goals), [правки фраз и разметка пауз](/ru/v4/platform/agent-settings/speech-corrections). Переключатели включаются, но эффекта не дают — там, где это так, страница говорит об этом прямо.
</Warning>

## Где что настраивается

<CardGroup cols={2}>
  <Card title="Промпт, модели и знания" icon="brain" href="/ru/v4/platform/agent-settings/prompt-and-models">
    Общий промпт и подстановка переменных в авторский текст, модель выполнения и классификатора, тир обслуживания, прогрев кэша, базы знаний, flex-режим.
  </Card>

  <Card title="Голос: STT, TTS и VAD" icon="microphone" href="/ru/v4/platform/agent-settings/voice">
    Распознавание и синтез речи, детектор речи и перебивания, фоновый звук, определение языка хода, нормализатор перед синтезом.
  </Card>

  <Card title="Правки фраз и паузы" icon="comment-dots" href="/ru/v4/platform/agent-settings/speech-corrections">
    Словарь замен организации и разметка `[pause N]`: как агент звучит, когда читает номера и суммы.
  </Card>

  <Card title="Запись и управление звонком" icon="phone" href="/ru/v4/platform/agent-settings/call-control">
    Запись разговора и её хранение, лимит длительности, напоминания при тишине, фраза при неудачном переводе.
  </Card>

  <Card title="Цели разговора" icon="list-check" href="/ru/v4/platform/agent-settings/goals">
    Что должно быть установлено в разговоре, как платформа отмечает выполненное и чего механизм принципиально не делает.
  </Card>

  <Card title="Аналитика, наблюдатели и вебхуки" icon="chart-simple" href="/ru/v4/platform/agent-settings/analytics">
    Разбор после звонка и пользовательские поля, наблюдатели с реакциями, post-call вебхуки.
  </Card>
</CardGroup>
