AI Platform Docs

Назначение Low-code Конструктора

Low-code Конструктор (Low-code IDE) — адаптированная для Платформы ИИ версия LangFlow с клиентской и серверной частями. Инструмент служит для визуального создания и проверки Потока (Flow) агента, а также для публикации проверенной версии схемы как Агента в каталоге Платформы ИИ.

Low-code Конструктор не исполняет промышленный запрос, не развертывает Low-code Runtime и не управляет записями Agent Registry и разрешениями SpiceDB.

Перед началом

Получите у администратора:

адрес Low-code Конструктора для вашей среды;
рабочую область, в которой разрешено создавать Flow;
право автора или редактора;
название разрешенной политики компонентов;
сведения о доступных профилях моделей в Vault без самих секретов.

Вход выполняется через SSO Платформы ИИ.

Создание схемы

Создайте пустой рабочий Flow.
Задайте понятное название и кратко опишите назначение агента.
Добавьте компонент входа сообщения.
Добавьте PlatformLLM и выберите разрешенный профиль модели.
Соедините выход модели с компонентом ответа.
Проверьте типы входных и выходных данных каждого соединения.
Сохраните рабочую версию до запуска проверки.

Разрешенные и отложенные компоненты

Доступный набор компонентов задает версия политики. Палитра показывает только разрешенные элементы, а серверная проверка отклоняет вручную добавленный или измененный JSON с компонентами вне политики. В действующей версии политики разрешено 32 компонента, сгруппированных по назначению.

Вход, выход и управление потоком

ChatInput — точка входа сообщения (обязательна, минимум одна);
ChatOutput — точка ответа (обязательна, минимум одна);
Webhook — вход по внешнему вызову;
ConditionalRouter — развилка по условию;
LoopComponent — повторение блока;
Listen, Notify — ожидание события и уведомление;
HumanInput — подтверждение или ввод от человека.

Модели и агенты

PlatformLLM (языковая модель) и EmbeddingModel — генерация и смысловые представления;
Prompt Template — шаблон промпта;
Agent, A2AAgent — вызов другого агента;
Memory — память диалога внутри схемы;
SciboxModelComponent — специализированная модель платформы.

Обработка данных

ParserComponent — разбор структурированных данных;
SplitText — разбивка текста на фрагменты;
TypeConverterComponent — преобразование типов;
DynamicCreateData — формирование данных на лету;
Operations — типовые операции над данными.

Источники данных и файлы

APIRequest — запрос к API;
URLComponent, UnifiedWebSearch — получение и поиск в веб;
MockDataGenerator — тестовые данные;
File, FileSystemTool, SaveToFile — чтение, работа с файлами и сохранение результата.

Операции LLM и утилиты

BatchRunComponent — пакетный запуск;
GuardrailValidator — проверка результата по правилам;
SmartRouter — маршрутизация запроса к подходящей модели;
CalculatorComponent — вычисления;
CurrentDate — текущая дата и время.

Компоненты, недоступные в этой версии

В версии 2026.3.5 в палитре и в публикации недоступны:

PlatformRAG и PlatformMemory — сервисы поставляются отдельно и подключаются только через Platform SDK;
компоненты произвольного кода (интерпретатор Python, «умное» преобразование) — исполняют пользовательский код, что политика запрещает;
SQLComponent (работы с базой данных), Knowledge, MemoryBase (накопительная база памяти), RunFlow (вложенный поток), LLMSelectorComponent, StructuredOutput — их поддержка средой исполнения еще не включена в текущий релиз;
MCPTools — отдельная возможность, не рекламируемая в текущем профиле публикации.

Требования к схеме

Чтобы схему приняли проверка и публикация:

в схеме есть хотя бы один ChatInput и один ChatOutput — они служат точками входа и выхода для вызова агента;
все узлы взяты из разрешенных в политике;
число узлов не превышает 128, число связей — 512;
разрешены ветвление и циклы.

Секреты и профили моделей

Flow не должен содержать ключ API, токен, пароль или адрес вызываемых сервисов. Для выбора модели используйте имя профиля Vault. Если нужного профиля нет:

сохраните схему без секрета;
запишите имя требуемого поставщика и рабочую область;
отправьте запрос администратору по принятому процессу управления секретами;
после создания профиля повторите проверку.

Важно: Не вставляйте временный ключ в текстовое поле, пользовательский код или экспортируемый JSON. Не прикладывайте секрет к сообщению об ошибке.

Сохранение версии

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

идентификатор;
номер рабочей версии;
время сохранения;
примененную политику компонентов;
версию Low-code Конструктора, если она отображается.

Low-code Конструктор не позволяет перезаписать уже зафиксированную версию: любая правка создает новую рабочую версию. Повторное сохранение одной неизмененной версии дает одинаковую контрольную сумму SHA-256.

Проверка

Запустите серверную проверку и дождитесь итогового состояния. Успешный результат должен содержать версию проверяющего модуля, версию политики и SHA-256 исходных данных.

Типичные ошибки:

Класс результата	Причина	Что исправить
`component_not_allowed`	Компонент отсутствует в действующей политике	Удалить компонент или выбрать разрешенную платформенную замену
Нарушение JSON Schema	Не хватает обязательного поля либо нарушен тип данных	Исправить указанное поле по пути JSON
Секрет в исходных данных	В схеме обнаружено значение, похожее на секрет	Удалить значение и использовать профиль Vault
Неверная точка входа	Нельзя однозначно определить вход или выход схемы	Проверить связи и обязательные компоненты
Несовместимость среды исполнения	Схема несовместима с принятой версией `lfx`	Удалить неподдерживаемую возможность либо создать совместимую версию

Подготовка к публикации

Публикации подлежит только рабочая версия Flow, прошедшая серверную проверку. Перед публикацией:

убедитесь, что в схеме нет ручных правок компонентов вне действующей политики;
удалите или замените секреты именами профилей Vault;
проверьте, что изменяемые поля Flow.data не несут данных, которые нельзя передать потребителю;
зафиксируйте номер рабочей версии и контрольную сумму SHA-256.

Не редактируйте JSON схемы вручную после успешной проверки: это отменит состояние проверки и потребует повторного прогона.

Публикация Агента

В версии 2026.3.5 Low-code Конструктор публикует проверенную версию Flow как Агента в каталоге Платформы ИИ прямо из интерфейса. Публикация выполняется через Control Plane:

Запустите проверку Flow и дождитесь успешного результата.
Откройте сохраненную рабочую версию и вызовите публикацию в интерфейсе Low-code Конструктора.
Система экспортирует Flow в канонический формат platform.low-code.flow/v2 и от вашего имени вызывает Control Plane через api-gw.
Control Plane выполняет проверку, создает запись Агента и версии, а также операцию публикации.
Publisher собирает артефакт и развертывает workload в Kubernetes.

Признаки успешной публикации:

ответ 202 Accepted означает, что операция публикации принята, а не что Агент уже готов к вызовам;
о завершении публикации говорит конечный статус операции в Control Plane;
напрямую обращаться в Control Plane из Low-code Конструктора нельзя — все запросы идут через api-gw.

Ограничения публикации:

изменяемые поля Flow.data в публикацию не попадают;
неизвестный или измененный вручную компонент отклоняется с ошибкой;
прямая загрузка схемы в OCI, Kubernetes или Agent Registry запрещена.

Проверка результата публикации

Когда операция публикации завершится:

откройте Agent Registry;
найдите Агента по названию и типу реализации low-code;
сравните опубликованную версию с рабочей версией схемы, которую вы публиковали;
убедитесь, что интерфейс вызова виден только при наличии соответствующего права;
выполните проверочный вызов через Platform Agent Gateway;
сохраните traceId и результат вызова без секретов.

Если операция публикации осталась в промежуточном состоянии, обратитесь к администратору Платформы ИИ с идентификатором операции из Low-code Конструктора.

Полная версия руководства пользователя

Полная версия руководства пользователя Low-code Конструктора интегрирована в пользовательский веб-интерфейс визуального редактора.

Работа в Low-code Конструкторе