Обзор компонентов

Описание

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

Рекомендации по оптимизации работы

Для ускорения процесса проектирования рекомендуется использовать горячие клавиши. Полный перечень доступных комбинаций представлен в разделе Settings -> Shortcuts.

Добавление компонентов

Чтобы добавить компонент, перетащите его из левого меню в рабочую область (Workspace). Компоненты разделены на логические группы:

• Inputs & Outputs: Узлы для получения данных от пользователя (Chat Input) и отправки ответов (Chat Output).
• Models: Прямые интеграции с LLM (OpenAI, Anthropic, GigaChat и др.).
• Data Sources: Компоненты для работы с внешними данными и векторными базами (Astra DB, файлы).
• Agents: Специальные узлы для создания автономных систем.
• Processing: Инструменты для преобразования данных (парсинг документов, разбиение текста).

Настройка и управление

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

Меню управления компонентом:

Кликните на заголовок компонента, чтобы открыть дополнительные опции.

• Code (</>)
  Предоставляет прямой доступ к исходному коду компонента на языке Python для внесения кастомных модификаций в логику его работы.

• Controls
  Открывает доступ ко всем скрытым и продвинутым настройкам, которые не отображаются на основной панели компонента.

• Tool Mode
  Переводит компонент в формат инструмента (Tool), что позволяет подключать его к агентам для выполнения специфических задач.

• Freeze
  Фиксирует текущее состояние компонента, предотвращая его повторный запуск при внесении изменений в другие сегменты потока.

Для доступа ко всем остальным опциям, включая команды Delete (Удалить) и Duplicate (Дублировать), нажмите ![][image9]Show More (Показать больше).

Переименование и описание

Чтобы изменить название или описание компонента, выделите его в рабочей области и нажмите кнопку Edit (Редактировать).

Важно: Поле описания поддерживает синтаксис Markdown, что позволяет добавлять форматирование, ссылки и списки.

Запуск компонента (Single Run)

Для выполнения одного конкретного узла нажмите Run component.

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

• Ограничение
  Запуск одиночного компонента не активирует выполнение вышестоящих (upstream) зависимостей автоматически.

Инспекция

Для детального анализа результатов выполнения и просмотра системных журналов конкретного модуля предусмотрена функция Inspect. Данный инструмент позволяет в реальном времени контролировать выходные данные и выявлять потенциальные ошибки в логике работы отдельного узла.

Заморозка (Freeze)

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

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

• Порядок активации
  Для включения данного режима необходимо выделить компонент в рабочей области, нажать кнопку Show More и выбрать опцию Freeze.

Порты и соединения

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

Типы данных и цвета

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

Совет: Наведите курсор на порт, чтобы увидеть детали, или кликните по нему для поиска совместимых компонентов. Если типы не совпадают, используйте узел Type Convert.

Динамические порты

Некоторые компоненты (например, Prompt Template) создают порты динамически. Если вы добавите переменную в фигурных скобках {variable_name} в текстовое поле, у компонента автоматически появится новый входной порт.

Программная база и код

Каждый компонент в составе конструктора представляет собой Python-класс, который наследуется от базового класса Component. Использование кнопки Code позволяет получить прямой доступ к программной реализации и изучить внутреннюю логику работы модуля.

Исходный код компонента регулирует следующие аспекты его функционирования:

• Отображение интерфейса
  Программная структура определяет перечень параметров и настроек, которые будут доступны пользователю для конфигурации в графическом интерфейсе (UI).

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

• Логика обработки информации
  Внутренние методы, включая ключевой метод build, описывают алгоритм трансформации данных и последовательность выполнения операций внутри компонента.

Пример структуры входов (inputs):

 inputs = [

     IntInput(name="chunk_size", display_name="Размер чанка", value=1000),

     DataInput(name="data_input", display_name="Входные данные", input_types=["Document", "Data"])

 ]

Группировка компонентов

Для организации сложных схем вы можете объединять несколько узлов в один групповой компонент.

1. Зажмите Shift и выделите область с нужными узлами (или используйте Ctrl/Cmd для выбора по одному).
2. Нажмите Group.
3. Теперь группа управляется как единый компонент с общим кодом и настройками.
4. Чтобы вернуть всё назад, выберите Show More → Ungroup.