Как читать страницу ноды
Все страницы справочника устроены одинаково и собираются из реестра нод — того самого, из которого редактор строит палитру. Поэтому там не бывает поля, которого нет в приложении, и не бывает порта, который нарисовали по памяти.
Карточка
Сверху — карточка ноды в том виде, в каком она выглядит на холсте: иконка, название и точки портов слева и справа.
Форма точки говорит, что через неё идёт:
- круг — только данные;
- треугольник — только исполнение (порядок, без значения);
- ромб — и то и другое одним ребром.
Цвет точки — это тип провода, те же цвета, что у рёбер на холсте. Полный список — на странице «Провода».
Бейджи
Рядом с названием могут стоять пометки:
- Tool — ноду можно подключить к агенту как инструмент, и модель вызовет её сама;
- Exec — у ноды есть вход исполнения, то есть она шаг графа, а не источник настроек;
- Subgraph — внутри неё исполняются другие ноды;
- Stateful — она хранит состояние между запусками.
Порты
Две таблицы, входы и выходы. В них полезны две колонки, которых нет на карточке:
- Данные — семантический тип полезной нагрузки (
message,dataframe,file…); - Примечания — обязателен ли порт, принимает ли несколько рёбер и при какой настройке он вообще показывается. Порт с условием на карточке может отсутствовать: он появится, когда вы включите соответствующий флаг.
Настройки
Таблица полей идёт в том же порядке и с той же группировкой, что и форма в редакторе: сначала основные, потом «Дополнительно». У поля видно тип, значение по умолчанию, варианты для списков и пометки — поддерживает ли оно шаблоны, перекрывается ли подключённым портом, является ли секретом.
Три поля (expose_error_output, split_ports_in, split_ports_out) спрятаны в отдельный
блок: они есть у каждой ноды, их добавляет платформа.
Пример
Почти на каждой странице есть минимальный воркфлоу с кнопкой «Скопировать ноды». Нажмите её, откройте редактор и нажмите Ctrl+V на холсте — граф вставится целиком, со связями. Вставленный вход подставится на уже существующий, поэтому вставлять можно и в непустой граф.