# Привязки и запуски

## Привязки (Bindings)

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

### Создание привязки

1. Откройте раздел **Пайплайны**
2. Нажмите **Добавить привязку**
3. **Шаг 1:** Выберите задачу сбора данных
4. **Шаг 2:** Выберите пайплайн (отображаются шаги пайплайна)
5. **Шаг 3:** Настройте фильтры и минимальное количество сообщений
6. Нажмите **Привязать**

{% hint style="warning" %}
Один пайплайн можно привязать к одной задаче только один раз. Уже привязанные пайплайны отображаются как недоступные.
{% endhint %}

{% hint style="warning" %}
Если пайплайн содержит шаг транскрибации, а задача сбора работает с мессенджерами (текстовыми чатами), отображается предупреждение — транскрибация для текстовых диалогов не нужна.
{% endhint %}

### Фильтры

Фильтры определяют, какие разговоры из задачи будут обработаны. Доступны два типа:

**Фильтры диалогов** (scope: `dialog`) — фильтрация по полям метаданных диалога

**Фильтры сообщений** (scope: `message`) — фильтрация по полям сообщений

Каждый фильтр состоит из трёх частей:

* **Поле** — ключ поля (из схемы данных)
* **Оператор** — `=`, `≠`, `>`, `<`, `≥`, `≤`, `includes`, `not_includes`
* **Значение** — искомое значение

Фильтры можно добавлять и удалять. Несколько фильтров работают по логике И (AND).

### Минимальное количество сообщений

Параметр `min_messages` (по умолчанию 2) позволяет пропускать слишком короткие диалоги.

### Оценка объёма

Нажмите **Оценить**, чтобы узнать, сколько разговоров из задачи соответствуют фильтрам. Отображается: `matched / total диалогов`.

### Предпросмотр данных

При настройке привязки можно просмотреть:

* **Пример тикета** — структура одного диалога из источника (JSON)
* **Пример сообщений** — массив сообщений (JSON)

***

## Ручной запуск

### Запуск пайплайна

Вы можете запустить пайплайн на конкретных разговорах:

* Укажите ID разговоров для обработки (от 1 до 1000)
* Пайплайн создаст запуск и обработает указанные разговоры

### Запуск привязки

Привязку можно запустить вручную для повторной обработки разговоров из определённого запуска задачи сбора. Если запуск не указан, используется последний завершённый.

***

## История запусков

Каждый запуск пайплайна фиксируется в истории:

| Поле                   | Описание                                                        |
| ---------------------- | --------------------------------------------------------------- |
| **Статус**             | `pending`, `running`, `completed`, `partially_failed`, `failed` |
| **Всего**              | Общее количество разговоров                                     |
| **Обработано**         | Количество успешно обработанных                                 |
| **Ошибки**             | Количество с ошибками                                           |
| **Длительность**       | Время выполнения (в формате «45 мин», «2 ч 30 мин»)             |
| **Начало / Окончание** | Время начала и завершения                                       |

{% hint style="warning" %}
Статус `partially_failed` означает, что часть разговоров обработана, а часть завершилась с ошибкой. Просмотрите детали запуска для диагностики.
{% endhint %}