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

# Потоки

> Проектируйте диалоговые деревья с блоками и связями. Создавайте визуальные потоки взаимодействия для управления разговорами вашего ИИ-агента.

Модуль **Потоки** позволяет строить **диалоговые потоки** визуально — представьте его как холст, на котором вы проектируете точный путь, по которому ваш ИИ-агент должен следовать во время разговора. Вместо того чтобы полагаться исключительно на свободные ответы ИИ, Потоки дают вам детальный контроль над тем, как взаимодействия разворачиваются шаг за шагом.

Используйте Потоки, когда вам нужны:

* **Структурированные разговоры:** Проведите пользователя через определённую последовательность (например, онбординг, устранение неполадок, сбор данных).
* **Пути эскалации к человеку:** Определите чёткие правила, когда и как разговор должен быть передан живому агенту.
* **Интеграции с API:** Вызывайте внешние сервисы в определённых точках разговора для получения или отправки данных.
* **Инструменты Lovi:** Используйте встроенные возможности Lovi внутри потока для продвинутых действий.

***

## Начало Работы

Когда вы впервые откроете раздел Потоки, вы увидите пустое состояние с приглашением создать ваш первый поток.

Нажмите кнопку **+ Новый поток** в правом верхнем углу (или кнопку **+ Создать мой первый поток** в центре), чтобы начать.

***

## Создание Нового Потока

Появится диалоговое окно с просьбой настроить базовые данные вашего потока:

| Поле                                | Описание                                                                                              |
| :---------------------------------- | :---------------------------------------------------------------------------------------------------- |
| **Название потока** *(обязательно)* | Описательное название для вашего потока (например, `Приветствие и политики`, `Отслеживание заказов`). |
| **Описание** *(необязательно)*      | Краткое объяснение, что делает этот поток. Полезно для синхронизации команды.                         |
| **ИИ-агент** *(обязательно)*        | ИИ-агент, к которому будет привязан этот поток. Выберите из выпадающего списка.                       |
| **Тип потока**                      | Выберите, как вы хотите начать построение.                                                            |

### Типы Потоков

| Тип                           | Описание                                                                                                                                 |
| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |
| **Пользовательский (пустой)** | Начните с нуля, имея только триггерный узел. Полная творческая свобода для создания собственного потока.                                 |
| **Эскалация к человеку**      | Предварительно настроенный шаблон, предназначенный для передачи разговоров от ИИ-агента к живому агенту. Идеально для потоков поддержки. |

После заполнения данных нажмите **Создать поток**, чтобы войти в редактор потоков.

***

## Редактор Потоков (Холст)

После создания потока вы будете перенаправлены в **редактор потоков** — интерактивный холст, где вы проектируете диалоговое дерево с помощью перетаскивания узлов и связей.

В верхней части редактора вы увидите:

* **Название потока** и **привязанного ИИ-агента**.
* Панель инструментов с доступными типами узлов.
* Кнопку **Сохранить** для сохранения изменений.

В нижнем левом углу находятся элементы управления холстом: **увеличить**, **уменьшить**, **подогнать под экран** и **заблокировать/разблокировать** холст.

***

## Типы Узлов

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

### 1. Узел Агента

**Узел Агента** представляет точку, где ИИ-агент говорит или выполняет действие. Используйте его для:

* Отправки сообщения пользователю.
* Обработки информации с помощью ИИ-движка.
* Принятия решений на основе контекста разговора.

Это самый распространённый узел — ИИ выполняет свою работу внутри потока.

### 2. Узел Пользователя

**Узел Пользователя** представляет точку, где система ожидает ввод от пользователя. Используйте его для:

* Захвата конкретного ответа пользователя.
* Ветвления потока на основе того, что пользователь говорит или выбирает.
* Сбора данных (имена, электронные адреса, предпочтения и т.д.).

Думайте о нём как о шаге «пауза и слушание» в разговоре.

### 3. Узел API

**Узел API** позволяет интегрировать внешние сервисы непосредственно в поток. Используйте его для:

* Получения данных из сторонней системы (например, статус заказа, информация об аккаунте).
* Отправки данных во внешний сервис (например, создание тикета, обновление CRM).
* Запуска вебхуков в определённых точках разговора.

Так ваш поток соединяется с внешним миром.

### 4. Узел Инструментов Lovi

**Узел Инструментов Lovi** даёт доступ к встроенным возможностям Lovi внутри потока. Используйте его для:

* Выполнения платформенных действий (например, пометить разговор тегом, назначить отделу).
* Использования продвинутых функций Lovi, выходящих за рамки простых текстовых ответов.
* Автоматизации внутренних операций в рамках диалогового потока.

***

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

Вот общий процесс построения диалогового потока:

1. **Начните с триггера:** Каждый поток начинается с триггерного узла, который определяет, когда поток запускается.
2. **Добавьте узлы:** Перетащите узлы с панели инструментов на холст.
3. **Соедините узлы:** Нарисуйте связи между узлами для определения пути разговора. Просто нажмите на выходной порт одного узла и перетащите к входному порту другого.
4. **Настройте каждый узел:** Нажмите на узел, чтобы открыть панель настроек и определить, что он делает (сообщения, условия, API-вызовы и т.д.).
5. **Сохраните:** Нажмите кнопку **Сохранить**, чтобы сохранить ваш поток.

### Советы для Эффективных Потоков

* **Сохраняйте простоту:** Начните с минимального потока и расширяйте по мере необходимости. Чрезмерно сложные деревья трудно поддерживать.
* **Тестируйте часто:** После сохранения протестируйте поток через привязанного ИИ-агента, чтобы убедиться, что разговор звучит естественно.
* **Используйте ветвление с умом:** Узлы пользователя могут разветвляться на несколько путей — используйте это для обработки различных намерений пользователя, не делая поток слишком глубоким.
* **Сочетайте с ИИ:** Потоки не заменяют ИИ — они направляют его. ИИ-агент по-прежнему обрабатывает нюансы; поток обеспечивает структуру.

***

## Лучшие Практики

* **Называйте потоки понятно:** Используйте описательные названия, чтобы ваша команда с первого взгляда знала, чем занимается каждый поток.
* **Один поток на цель:** Вместо создания одного огромного потока создавайте отдельные потоки для разных целей (например, один для онбординга, другой для эскалации поддержки).
* **Документируйте описаниями:** Используйте поле описания при создании потока — ваше будущее я (и ваши коллеги) скажут вам спасибо.
* **Проверяйте и улучшайте:** Потоки — это живые документы. Проверяйте аналитику, чтобы видеть, где пользователи уходят, и улучшайте пути соответственно.

***

## Краткий Справочник

| Действие            | Как                                                   |
| :------------------ | :---------------------------------------------------- |
| Создать новый поток | Нажмите **+ Новый поток** в правом верхнем углу       |
| Добавить узел       | Нажмите кнопку типа узла на панели инструментов       |
| Соединить узлы      | Перетащите от выхода одного узла ко входу другого     |
| Настроить узел      | Нажмите на узел на холсте                             |
| Сохранить изменения | Нажмите кнопку **Сохранить**                          |
| Увеличить/Уменьшить | Используйте элементы управления внизу слева на холсте |
| Подогнать под экран | Нажмите иконку подгонки под экран внизу слева         |