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

# Flow Builder

> Дизайнирайте разговори визуално с интуитивен drag-and-drop интерфейс

Flow Builder е визуален drag-and-drop редактор за разговорни потоци, който ви позволява да дизайнирате скриптове за AI асистенти без писане на код. Създавайте многостъпкови разговорни потоци чрез свързване на възли, които представляват различни действия и точки за вземане на решения.

## Общ преглед

Flow Builder предоставя:

* **Визуален дизайн** - Drag-and-drop възли на платно
* **Множество типове възли** - Съобщения, подсказки, действия и други
* **Разклонителна логика** - Създаване на различни пътища въз основа на отговори
* **Панел с настройки** - Конфигуриране на личност и поведение на агента
* **Import/Export** - Запазване и споделяне на потоци като JSON файлове

<Frame>
  <img src="https://mintcdn.com/aiployees/mV__UiF1j83HXN8M/resources/ai-assistants/flow-builder-overview.png?fit=max&auto=format&n=mV__UiF1j83HXN8M&q=85&s=23fd31018fbab6a5432ddb38e5b4963c" alt="Flow Builder Interface" width="937" height="610" data-path="resources/ai-assistants/flow-builder-overview.png" />
</Frame>

## Кога да използвате Flow Builder

<CardGroup cols={2}>
  <Card title="Използвайте Flow Builder за" icon="check">
    * Структурирани разговорни скриптове
    * Многопътни дървета за решения
    * Сложни потоци от разговори с разклонения
    * Визуално мислещи хора, които предпочитат диаграми
  </Card>

  <Card title="Използвайте Classic Editor за" icon="pen">
    * Прости, линейни разговори
    * Силно динамични AI отговори
    * Бързи итерации на подсказки
    * Редактиране фокусирано върху текст
  </Card>
</CardGroup>

## Първи стъпки

<Steps>
  <Step title="Отворете вашия асистент">
    Отидете в **Assistants** и кликнете върху асистента, който искате да редактирате.
  </Step>

  <Step title="Намерете Flow Builder">
    В формата за редактиране се спуснете до секцията **System Prompt** и кликнете върху таба **Flow Builder**.
  </Step>

  <Step title="Стартирайте Flow Builder">
    Кликнете **Launch Flow Builder**. Ще се отвори редактор на цял екран.
  </Step>

  <Step title="Изберете как да започнете">
    * **Continue with existing** - Редактирайте вашия текущ поток
    * **Start from scratch** - Започнете само със Start възел
    * **Start with template** - Заредете предварително изграден шаблон за поток
  </Step>
</Steps>

## Преглед на интерфейса

### Област на платното (център)

Основното работно пространство, където изграждате вашия поток:

* **Възли** - Плъзнете за преместване
* **Връзки** - Линии показващи потока между възлите
* **Мрежа във фона** - Помага за подравняване
* **Контроли за мащабиране** - Увеличаване/намаляване и напасване в изгледа
* **Панорамиране** - Кликнете и плъзнете на празно пространство за придвижване

### Долна лента с инструменти

Бързи действия за управление на вашия поток:

| Бутон          | Действие                              |
| -------------- | ------------------------------------- |
| ⚡ Auto Layout  | Автоматично подреждане на възлите     |
| 📋 Duplicate   | Копиране на избрания възел            |
| 🗑️ Delete     | Премахване на избран възел или връзка |
| **+ Add Node** | Добавяне на нов възел към платното    |

### Панел с настройки (дясна страна)

Конфигурирайте личността и поведението на вашия асистент:

* **Agent Name** - Името, което вашият AI ще използва
* **Agent Type** - Sales, Support, Survey и др.
* **Language** - Говорим език за разговорите
* **Assertiveness** - Колко настойчив трябва да бъде AI-ят
* **Humor** - Ниво на хумор в отговорите
* **Variables** - Полета с данни преди разговора
* **Post-Call Fields** - Данни за събиране след разговорите

## Типове възли

Flow Builder има 5 типа възли, всеки със специфична цел:

<Frame>
  <img src="https://mintcdn.com/aiployees/mV__UiF1j83HXN8M/resources/ai-assistants/flow-builder-nodes.png?fit=max&auto=format&n=mV__UiF1j83HXN8M&q=85&s=95d9fde0e8a240e1fdc903f470f2bdb6" alt="Flow Builder Node Types" width="907" height="590" data-path="resources/ai-assistants/flow-builder-nodes.png" />
</Frame>

### Start възел (зелен)

<Card title="Start възел" icon="play" color="#22c55e">
  Входната точка на всеки разговор. Всеки поток трябва да има точно един Start възел.

  **Свойства:**

  * **Greeting** - Началното съобщение когато разговорът започне

  **Пример:** "Здравейте, аз съм Сара от Acme Insurance. Как сте днес?"
</Card>

### Speak възел (син)

<Card title="Speak възел" icon="volume-high" color="#3b82f6">
  Предава предварително написано съобщение точно както е зададено. Използвайте когато се нуждаете от точна формулировка.

  **Свойства:**

  * **Text** - Точното съобщение за произнасяне
  * **Outcomes** - Различни пътища въз основа на отговора на клиента

  **Пример:** "Предлагаме временна 20% отстъпка на всички планове. Искате ли да чуете повече?"
</Card>

### Prompt възел (лилав)

<Card title="Prompt възел" icon="message" color="#a855f7">
  Дава на AI-я инструкции как да отговори. По-гъвкав от Speak възлите - AI-ят генерира контекстуални отговори.

  **Свойства:**

  * **Prompt** - Инструкции за AI-я
  * **Outcomes** - Различни пътища въз основа на категориите отговори

  **Пример за подсказка:** "Попитайте клиента за настоящата му застраховка. Бъдете разговорливи и емпатични. Слушайте за споменавания на размера на семейството, грижи за бюджета или времеви график."
</Card>

### Action възел (оранжев)

<Card title="Action възел" icon="bolt" color="#f97316">
  Изпълнява специални действия по време на разговора.

  **Типове действия:**

  * **Call Forward** - Пренасочване към друг номер
  * **Book Appointment** - Планиране с помощта на свързан календар
  * **Custom Action** - Задействане на персонализиран инструмент по време на разговора

  **Пример:** Пренасочване към отдела продажби на +1-555-123-4567 когато клиентът е готов за покупка.
</Card>

### End възел (червен)

<Card title="End възел" icon="phone-slash" color="#ef4444">
  Прекратява разговора или пренасочва към друга дестинация.

  **Типове завършване:**

  * **End Call** - Затваряне със заключително съобщение
  * **Forward Call** - Пренасочване към телефонен номер
  * **Transfer Agent** - Предаване на друг асистент

  **Пример за заключение:** "Благодаря ви за времето днес. Приятен ден!"
</Card>

## Работа с възли

### Добавяне на възли

1. Кликнете **+ Add Node** в долната лента с инструменти
2. Изберете типа възел от падащото меню
3. Възелът се появява на платното
4. Плъзнете го до желаната позиция

### Свързване на възли

1. Задръжте над долния край на възела за да видите **output handle** (малка окръжност)
2. Кликнете и плъзнете от output handle
3. Свържете към **input handle** на друг възел (горен край)
4. Отпуснете за създаване на връзката

### Редактиране на възли

1. Кликнете върху всеки възел за да го изберете
2. Свойствата на възела се появяват в панел
3. Редактирайте текста, подсказката или настройките
4. Промените се запазват автоматично в платното

### Изтриване на възли

* Изберете възел и натиснете клавиша **Delete**, или
* Изберете възел и кликнете бутона 🗑️ в лентата с инструменти

<Warning>
  Start възелът не може да бъде изтрит. Всеки поток трябва да има един Start възел.
</Warning>

## Резултати (множество пътища)

Speak и Prompt възлите могат да имат множество **резултати** - различни пътища въз основа на това как клиентът отговаря.

### Добавяне на резултати

1. Изберете Speak или Prompt възел
2. В панела със свойства намерете **Outcomes**
3. Кликнете **Add Outcome**
4. Именувайте резултата (напр. "Интересува се", "Не се интересува", "Иска обратно обаждане")

### Свързване на резултати

Всеки резултат се появява като цветна точка в долната част на възела. Свържете всеки резултат към различен възел-дестинация за създаване на разклонителна логика.

<Frame>
  <img src="https://mintcdn.com/aiployees/mV__UiF1j83HXN8M/resources/ai-assistants/flow-builder-branching.png?fit=max&auto=format&n=mV__UiF1j83HXN8M&q=85&s=ac612f32735296281a8b3833b62da6e6" alt="Conversation Branching with Outcomes" width="547" height="425" data-path="resources/ai-assistants/flow-builder-branching.png" />
</Frame>

**Пример за поток:**

```
[Start] → [Попитай за интерес]
              ↓
         [Prompt: "Попитай дали се интересува"]
              ↓
    ┌─────────┼─────────┐
    ↓         ↓         ↓
[Интересува се] [Може би] [Не се интересува]
    ↓         ↓         ↓
[Запиши демо] [Изпрати информация] [Благодари и завърши]
```

## Панел с настройки

<Frame>
  <img src="https://mintcdn.com/aiployees/mV__UiF1j83HXN8M/resources/ai-assistants/flow-builder-settings.png?fit=max&auto=format&n=mV__UiF1j83HXN8M&q=85&s=c74a1014069b4b6a430fb974ab25582d" alt="Flow Builder Settings Panel" width="287" height="627" data-path="resources/ai-assistants/flow-builder-settings.png" />
</Frame>

### Самоличност на агента

| Настройка      | Описание                                     |
| -------------- | -------------------------------------------- |
| **Agent Name** | Името, което AI използва за представяне      |
| **Agent Type** | Готова личност: Sales, Support, Survey и др. |
| **Language**   | Основен език за разговора                    |

### Личност

| Настройка         | Опции                             | Описание                   |
| ----------------- | --------------------------------- | -------------------------- |
| **Assertiveness** | Ниска / Средна / Висока           | Колко упорит е AI-ят       |
| **Humor**         | Изключен / Нисък / Среден / Висок | Ниво на хумор в отговорите |

### Променливи

Добавете данни преди разговора, които могат да бъдат използвани в съобщенията ви:

1. Кликнете **Add Variable**
2. Въведете **Name** (напр. `product_interest`)
3. Задайте **Default Value**

Използвайте променливи в съобщения с къдрави скоби: `{variable_name}`

**Пример:** "Здравейте {customer_name}, виждам че се интересувахте от нашия {product_interest}."

### Полета след разговора

Дефинирайте данни за извличане от разговорите:

1. Кликнете **Add Field**
2. Въведете **Name**, **Type** и **Description**
3. AI-ят ще се опита да попълни тези полета въз основа на разговора

**Типове:** `string`, `number`, `boolean`

## Import/Export

### Експортиране на вашия поток

1. Отворете панела Settings
2. Спуснете се до дъното
3. Кликнете **Export JSON**
4. Запазете `.json` файла

### Импортиране на поток

1. Кликнете **Import JSON** в настройките
2. Изберете вашия `.json` файл
3. Потокът се зарежда на платното

<Tip>
  Експортирайте потоците си редовно като резервни копия. По този начин можете също да споделяте потоци с членове на екипа.
</Tip>

## Настройки за гласова поща

Конфигурирайте какво се случва когато се открие гласова поща:

* **Voicemail Message** - Съобщение за оставяне ако гласовата поща отговори
* **End Call on Voicemail** - Превключвател за автоматично затваряне при гласова поща

## Запазване на вашия поток

Кликнете бутона **Save** в горния десен ъгъл за запазване на потока към асистента.

<Note>
  Потокът се съхранява като JSON в полето за system prompt на вашия асистент. Ако превключите към Classic Editor, ще видите суровите JSON данни.
</Note>

## Най-добри практики

<CardGroup cols={2}>
  <Card title="Започнете просто" icon="seedling">
    Започнете с основен поток и добавяйте сложност постепенно. Тествайте на всяка стъпка.
  </Card>

  <Card title="Използвайте Prompt възли" icon="brain">
    Prompt възлите дават гъвкавост на AI-я. Използвайте ги за динамични, контекстуални отговори.
  </Card>

  <Card title="Планирайте резултатите си" icon="diagram-project">
    Преди изграждане скицирайте основните пътища: положителни, отрицателни и неутрални отговори.
  </Card>

  <Card title="Тествайте основно" icon="vial">
    Правете тестови обаждания покриващи всички пътища. Проверете дали всеки резултат води до правилната дестинация.
  </Card>
</CardGroup>

## Отстраняване на неизправности

<AccordionGroup>
  <Accordion title="Възлите не се свързват">
    * Уверете се, че плъзгате от **output handle** (долу) към **input handle** (горе)
    * Проверете дали не създавате кръгова връзка
    * Start възелът има само изход, End възелът има само вход
  </Accordion>

  <Accordion title="Потокът не се запазва">
    * Проверете интернет връзката си
    * Уверете се, че имате поне един възел (освен Start)
    * Потърсете грешки за валидиране в панела с настройки
  </Accordion>

  <Accordion title="AI-ят не следва потока">
    * Използвайте Speak възли за точни изисквания за формулировка
    * Направете инструкциите на Prompt възела по-специфични
    * Проверете дали резултатите са ясно дефинирани и свързани
  </Accordion>
</AccordionGroup>

## Свързани ресурси

* [AI Prompt Editor](/ai-assistants/ai-prompt-editor) - Чат-базирана алтернатива за редактиране на подсказки
* [System Prompts Guide](/ai-assistants/system-prompt) - Разбиране на основите на подсказките
* [Testing Your Assistant](/ai-assistants/testing) - Как да тествате вашите потоци

***