> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ukrgsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Конструктор голосового агента

> Конструктор дозволяє будувати розмову як граф вузлів і переходів. Огляд моделі графа, типів вузлів і з чого почати.

<img src="https://mintcdn.com/ukr-gsm/pisYMZLRPGIEw4_r/images/create-a-voice-agent.png?fit=max&auto=format&n=pisYMZLRPGIEw4_r&q=85&s=a07a82a8c172c4737e74e664ea0f098c" alt="Створення голосового агента" width="1716" height="1518" data-path="images/create-a-voice-agent.png" />

Конструктор голосового агента — це візуальний, побудований на графі редактор, який визначає, що агент каже і робить під час дзвінка. Замість одного величезного промпту розмова розбивається на **вузли** (етапи розмови), з'єднані **переходами** (шляхами, якими LLM може рухатись між етапами, залежно від того, як розвивається розмова).

Новий сценарій створюється з кабінету. Опишіть, чи потрібен вам агент для вхідних чи вихідних дзвінків, і ваш сценарій використання — це передається LLM, яка генерує стартовий сценарій з промптами й переходами за замовчуванням, який ви потім редагуєте.

## Модель графа

Сценарій — це орієнтований граф:

* **Вузли** відповідають етапу розмови або дії (наприклад, привітати абонента, зібрати адресу, перевести дзвінок).
* **Переходи (ребра)** з'єднують вузли й визначають шляхи, якими LLM може рухатись залежно від того, що каже абонент. LLM обирає потрібний перехід під час виконання дзвінка.

Сценарій повинен мати рівно один вузол **Початок дзвінка** і зазвичай завершується вузлом **Завершення дзвінка**, а між ними — вузли **Вузол агента** та інші типи вузлів. Дивіться [Редагування сценарію](/voice-agent/editing-a-workflow), щоб зрозуміти, як вузли, переходи й перемикачі на рівні вузла працюють разом.

## Типи вузлів

| Вузол                                           | Що робить                                                                                                                                |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| [**Початок дзвінка**](/voice-agent/start-call)  | Починає дзвінок і налаштовує привітання агента. Має бути лише один на сценарій.                                                          |
| [**Вузол агента**](/voice-agent/agent)          | Містить промпт, що керує розмовою на цьому етапі; з'єднується з іншими вузлами через переходи.                                           |
| [**Глобальний вузол**](/voice-agent/global)     | Спільні інструкції (тон, робота з запереченнями), що додаються на початок промпту кожного вузла з увімкненим «Додати глобальний промпт». |
| [**QA-аналіз**](/voice-agent/qa)                | Запускає автоматичний аналіз якості дзвінка за критеріями, які ви задаєте.                                                               |
| [**API-тригер**](/voice-agent/api-trigger)      | Відкриває ендпоінт, через який зовнішні системи (ваш бекенд, n8n, Zapier тощо) можуть запускати вихідні дзвінки.                         |
| [**Завершення дзвінка**](/voice-agent/end-call) | Налаштовує фінальну репліку агента перед завершенням дзвінка. Сценарій може мати кілька вузлів завершення, кожен зі своїм промптом.      |
| [**Вебхук**](/voice-agent/webhook)              | Надсилає результати дзвінка у зовнішню систему (CRM, Zapier, n8n) після завершення запуску.                                              |

Окрім вузлів, агента можна розширити:

* [**Інструменти**](/voice-agent/tools/introduction) — дозволяють LLM викликати зовнішні API, переводити дзвінки або звертатись до MCP-серверів під час розмови.
* [**База знань**](/voice-agent/knowledge-base) — прикріпіть документи, на які агент може посилатись під час дзвінка.
* [**Отримання даних перед дзвінком**](/voice-agent/pre-call-data-fetch) — збагачуйте контекст HTTP-запитом ще до того, як агент почне говорити.
* [**Попередньо записане аудіо**](/voice-agent/pre-recorded-audio) — поєднуйте реальні записи з мовленням, згенерованим LLM.
* [**Шаблонні змінні**](/voice-agent/template-variables) — посилайтесь на значення `initial_context` і `gathered_context` у промптах і тілах запитів.

## З чого почати

1. **Вперше в конструкторі?** Пройдіть [Редагування сценарію](/voice-agent/editing-a-workflow), щоб освоїти основи вузлів і переходів.
2. **Хочете перевірити одразу?** Скористайтесь Web Call прямо з редактора агента — без налаштування телефонії.
3. **Готові запускати наживо?** Налаштуйте провайдера телефонії та додайте [API-тригер](/voice-agent/api-trigger) або налаштуйте маршрутизацію вхідних дзвінків.
4. **Потрібно передавати результати у ваші системи?** Додайте вузол [Вебхук](/voice-agent/webhook), щоб синхронізувати результати з CRM чи інструментом автоматизації.
5. **Хочете вбудувати агента на сайт?** Дивіться [Додавання на сайт](/voice-agent/add-to-website).

## Дивіться також

* [Редагування сценарію](/voice-agent/editing-a-workflow)
* [Шаблонні змінні](/voice-agent/template-variables)