Связи и подстановки
Сценарий — это не просто набор модулей, а их связи. Здесь — про два разных понятия: линия между модулями и подстановка значения в конкретное поле.
Связь и подстановка — это разное
- Связь (линия)
- Говорит «второй модуль ждёт окончания первого». Внутри активной схемы это означает зависимость между модулями; без связи такой зависимости нет.
- Подстановка
- Говорит «вот это конкретное поле второго модуля заполняется результатом первого». Подстановка делается в настройках модуля: вы выбираете источник и конкретный результат.
Поле берёт данные из модуля «Идея»: первый результат. Источник должен быть выше по схеме; линия на рабочей области отвечает за порядок выполнения, а это поле — за подстановку данных.
Входной модуль: Текст
Генерация изображения
Связь соединяет модули
Линия на рабочей области отвечает за порядок выполнения: следующий модуль стартует только после того, как закончатся предыдущие.
Представьте сценарий как цепочку: сначала пользователь вводит идею, затем нейросеть создаёт картинки, потом другая модель оживляет их, а в конце утилита склеивает видео. Линии между модулями показывают, кто кого ждёт.
Входной модуль: Текст
Генерация изображений
Видео-модель
Утилита
Важно: связь сама по себе не означает «передать все данные дальше». Она только соединяет модули в активную схему. Какие именно данные попадут в конкретное поле, выбирается в настройках этого поля через подстановку.
Подстановка берёт конкретный результат
Подстановка настраивается не на линии, а в поле модуля: откуда взять значение и какой результат использовать.
Источник не обязан быть соединён с текущим модулем напрямую. Данные можно брать из любого предыдущего модуля, который находится выше в той же активной цепочке. Например, модуль «Оживление» может взять картинку из «Картинки», а текстовый промпт — из самого первого модуля «Идея».
По умолчанию поле обычно стоит в режиме «Заполнить вручную». Если открыть список, ниже появятся предыдущие модули. Совместимые источники идут первыми, а несовместимые остаются видимыми с пометкой «несовместимо», чтобы было понятно, почему такая подстановка может дать ошибку.
Типы данных и совместимость
Поле принимает только совместимое значение. Тип нельзя «привести» вручную — нужно использовать промежуточные модули-утилиты.
- Текст
- Любая текстовая строка.
- Картинка
- Одно изображение.
- Видео
- Один видеофайл.
- Аудио
- Один аудиофайл.
- Файл
- Произвольный файл без проверки типа.
- Число
- Целое или дробное число.
- JSON / структура
- Структурированные данные (например, список объектов).
- Список
- Несколько значений одного типа: например, список картинок или список текстов.
Селекторы: первая, последняя, по индексу, все
Когда у источника несколько значений, нужно выбрать, какое из них пойдёт в поле.
- Первая
- Берёт первое значение из списка. Самый частый выбор для «возьми лучший вариант».
- Последняя
- Берёт последнее значение. Удобно после модулей, которые в конце возвращают «итоговый» результат.
- По индексу
- Берёт значение под нужным номером (1, 2, 3…). Удобно для разных веток одного списка.
- Все
- Передаёт весь список целиком. Доступно только полям, которые принимают список.
В интерфейсе это второй список «Результат»: «Взять первый результат», «Взять последний результат», «Взять результат №2» или «Взять все результаты». Для одной картинки чаще выбирают первый результат, а для склейки, цикла или общего набора файлов — все результаты.
Несколько источников для файлов
Если поле нейросети или утилиты может принимать несколько файлов, вместо одного источника появляется список источников.
У некоторых полей можно передать сразу несколько изображений, видео, аудио или файлов. Тогда в настройках появляется кнопка «Добавить источник». Каждый источник — это отдельная строка: сначала выбираем модуль, затем конкретный результат этого модуля.
Так можно собрать общий набор: например, взять все ролики из «Оживления» и добавить к ним первую «Заставку». Пока у поля есть источники из модулей, ручная загрузка в это же поле отключается, чтобы данные не смешивались неявно.
Источники файлов
Пока у поля есть источники из модулей, ручная загрузка отключена.
Правила, которые проверяет конструктор
Перед запуском сценарий проходит автоматическую проверку. Подстановка считается некорректной, если:
- источник не является предком целевого модуля в активной схеме;
- в источнике нет такого поля или его результат не описан;
- типы источника и целевого поля несовместимы;
- в одно поле подставлено несколько источников одновременно (за исключением полей, которые поддерживают слияние нескольких файлов).
Все такие случаи показываются красной подсветкой в настройках модуля и в бейдже готовности в верхней панели.