Настройка процессора

Каждый процессор в воронке имеет набор параметров, определяющих его поведение. В этом руководстве вы узнаете, как открыть настройки процессора, заполнить конфигурацию, настроить фильтры и вычисляемые поля.

Открытие настроек процессора

Чтобы открыть панель настроек, кликните на узел процессора в визуальном редакторе. Справа появится панель с несколькими вкладками:

• Конфигурация - основные параметры процессора
• Фильтры - условия фильтрации входных данных
• Схема данных - описание входных и выходных полей
• Вычисляемые поля - формулы для расчёта новых полей

Вкладка “Конфигурация”

Здесь задаются параметры, специфичные для каждого типа процессора. Например:

• Загрузка файла: путь к файлу, разделитель, кодировка
• Поиск в реестрах: поисковый запрос, тип поиска, лимит результатов
• GPT-фильтр: промпт, модель, температура
• CRM-процессор: тип сущности, маппинг полей

Заполнение параметров

1. Откройте вкладку “Конфигурация”.
2. Заполните обязательные поля (отмечены звёздочкой).
3. При необходимости измените значения по умолчанию.
4. Нажмите “Сохранить”.

Использование переменных в параметрах

В текстовых полях конфигурации можно использовать переменные для подстановки данных из других процессоров. Синтаксис:

{{имяПроцессора.имяПоля}}

Например, если процессор “file-upload” выдаёт поле inn, то в настройках следующего процессора можно написать:

{{file-upload.inn}}

Система автоматически подставит значение ИНН из каждого пакета данных при обработке.

Подробнее о переменных читайте в руководстве Использование переменных.

Вкладка “Фильтры”

Фильтры позволяют отбирать только нужные пакеты данных для обработки. Это полезно, когда предыдущий процессор выдаёт много записей, но вам нужны только определённые.

Настройка простого фильтра

1. Перейдите на вкладку “Фильтры”.
2. В поле условия введите выражение, например: status = 'active'
3. Сохраните настройки.

Примеры фильтров

-- Фильтр по статусу
status = 'active'

-- Комбинация условий
revenue > 1000000 AND region = 'Москва'

-- Проверка на наличие значения
email IS NOT NULL

-- Поиск по шаблону
name LIKE '%ООО%'

Подробнее о фильтрах - в руководстве Настройка фильтров.

Вкладка “Схема данных”

Схема данных описывает структуру входных и выходных полей процессора.

Входная схема

Определяет, какие поля процессор ожидает на входе. Обычно формируется автоматически на основе связей с другими процессорами.

Выходная схема

Определяет, какие поля процессор создаёт в результате работы. Вы можете:

1. Просмотреть список выходных полей и их типы.
2. Добавить описания полей для документирования.
3. Использовать имена выходных полей как переменные в последующих процессорах.

Вкладка “Вычисляемые поля”

Вычисляемые поля позволяют создавать новые поля на основе существующих данных без написания кода.

Добавление вычисляемого поля

1. Перейдите на вкладку “Вычисляемые поля”.
2. Нажмите “Добавить поле”.
3. Укажите имя нового поля.
4. Введите формулу для расчёта.
5. Сохраните настройки.

Примеры формул

-- Объединение строк
fullName = {{lastName}} + ' ' + {{firstName}}

-- Условное значение
category = IF({{revenue}} > 1000000, 'Крупный', 'Малый')

Сохранение конфигурации

После внесения изменений в любую вкладку нажмите “Сохранить” в панели настроек. Затем сохраните воронку кнопкой “Сохранить” в верхней панели редактора.

Важно: изменения в конфигурации процессора вступают в силу при следующем запуске воронки. Если воронка уже выполняется, текущий запуск будет использовать предыдущую конфигурацию.

Советы по настройке

• Начинайте с малого: при первом запуске установите небольшой лимит записей (например, maxPackets: 5), чтобы проверить корректность настроек.
• Проверяйте переменные: убедитесь, что имя процессора-источника и поля указаны верно. Опечатка приведёт к пустому значению.
• Используйте фильтры: если обрабатываете большой объём данных, фильтры помогут сократить время выполнения и расход токенов.
• Документируйте схему: добавляйте описания к полям, чтобы было понятно назначение каждого поля при возвращении к воронке позднее.

Что дальше

• Использование переменных - подробнее о шаблонах и подстановке данных
• Настройка фильтров - продвинутые техники фильтрации
• Решение проблем - что делать, если что-то пошло не так