> ## 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: что это, как создать первого и где что описано.

# Голосовые агенты

Агенты — это ядро HubTalk AI v4. Это голосовые интерфейсы, которые вы создаёте один раз и запускаете для клиентов: они объединяют распознавание речи, промпты и бизнес-логику в едином сценарии.

## Что делают агенты

Агент может:

* поприветствовать звонящего и ответить на вопросы
* собрать данные клиента в ходе разговора
* перевести звонок на оператора
* корректно завершить разговор
* отправить результаты звонка в ваши системы через вебхуки

## Как создать агента

Откройте раздел **Агенты** и нажмите **Создать агента**. После этого откроется экран создания агента.

Интерфейс создания показывает панель настроек с секциями Функции, Переменные, Пост-обработка, VAD, Настройки звонка, Настройки речи, Webhook и База знаний — все они описаны в [Настройке агента](/ru/v4/platform/agent-settings).

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_agents_create.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=eb8c67cbe21d61bf102fae79f49fd529" alt="Кнопка Создать агента и панель настроек только что созданного агента" width="1440" height="900" data-path="images/v4_agents_create.png" />

## С чего начать

Начните с чёткой цели звонка: поддержка, запись на приём, уточнение заказа или квалификация лида. От неё зависит всё остальное.

Дальше соберите минимальный сценарий и доведите до конца именно его, а не все ветки сразу:

1. **Приветствие** — первое сообщение, которое слышит абонент. Дружелюбное и понятное; на нём же решается, кто говорит первым.
2. **Цель разговора** — какие данные агент должен получить и что считается успехом.
3. **Условия перевода и завершения** — когда агент отдаёт звонок человеку, а когда прощается сам.

Затем настройте язык и голос, промпт и действия — перевод, завершение, вебхуки и логику после звонка. Когда счастливый путь работает от начала до конца, добавляйте ветвления.

<Note>
  **Сначала опубликуйте, потом раздавайте.** Участник выбирает агента для кампании только из опубликованных, поэтому первая публикация делает агента видимым для всей организации. Недоделанного агента скрывают **до** неё — см. [Список агентов и доступ](/ru/v4/platform/agents/list).
</Note>

## Где что описано

<CardGroup cols={2}>
  <Card title="Список агентов и доступ" icon="table-list" href="/ru/v4/platform/agents/list">
    Таблица агентов и папки организации, переименование и удаление, настройка «Видно участникам» и что именно скрывается.
  </Card>

  <Card title="Ноды сценария" icon="diagram-project" href="/ru/v4/platform/agents/nodes">
    Девять типов нод — Conversation, Function, Code, Logic Split, Extract Variables, Transfer, Component, MCP Tool, End — и поля каждой.
  </Card>

  <Card title="Работа в редакторе" icon="pen-ruler" href="/ru/v4/platform/agents/building">
    Поиск по документу, переменные агента, вкладка ошибок, тест сценария и запуск с выбранной ноды.
  </Card>

  <Card title="Настройка агента" icon="sliders" href="/ru/v4/platform/agent-settings">
    Промпт и модели, голос, запись и управление звонком, цели разговора, аналитика и вебхуки.
  </Card>
</CardGroup>

## Что дальше

После настройки агента подключите его к [телефонии](/ru/v4/platform/telephony) и [вебхукам](/ru/v4/webhooks), чтобы результаты звонков были доступны вашей команде.