Нейристор «Документ» (Document)
Узел Документ эволюционировал из простой текстовой метки на холсте в полноценный мультимедийный контейнер. Теперь он способен хранить изображения, текстовые документы, пути к локальным файлам и передавать их в нейронную сеть (ИИ) в удобном для обработки формате.
Поведение узла, его внешний вид в редакторе и то, как он обрабатывает входящие сигналы, зависит от системного свойства _type.
1. Режимы работы (свойство _type)
Для изменения режима выделите узел и в панели свойств укажите одно из следующих значений для _type:
- help или document — классический режим. Узел выглядит как компактный прямоугольник (стикер). Используется для создания текстовых заметок и комментариев на графе.
- images — галерея изображений.
- documents — архив текстового содержимого (чтение текстов из TXT, PDF, DOCX прямо в память узла).
- files — реестр путей к локальным файлам.
Примечание: Если выбраны режимы images, documents или files, узел на холсте превращается в большой желтый интерактивный квадрат.
2. Использование в визуальном редакторе графа
Если узел переведен в мультимедийный режим (images, documents, files), он становится интерактивным контейнером, внутри которого можно хранить множество файлов/записей.
Интерактивная панель управления
В нижней части узла появляется панель с кнопками <, + и >:
- Кнопка + (Добавить): Открывает системное окно выбора файла (поддерживаются форматы JPG, PNG, PDF, DOCX, TXT).
- После выбора файла система попросит ввести ключ (уникальное имя, без символа _).
- В зависимости от _type, система либо сохранит саму картинку в Base64 (images), либо извлечет весь текст из документа (documents), либо сохранит путь к файлу (files).
- Кнопки < и > (Навигация): Позволяют «перелистывать» сохраненные в узле файлы.
- При перелистывании узел автоматически обновляет свое системное свойство _summary, записывая в него ключ текущего выбранного элемента.
- Если это картинка — она сразу отобразится на узле. Если это документ — вы увидите фрагмент его текста прямо на холсте.
Секрет механики: Все добавленные файлы хранятся в словаре свойств (Variables) узла под своими уникальными ключами. А свойство _summary выступает в роли “указателя” на то, какой именно файл сейчас активен на экране.
3. Обработка сигналов и выдача результатов (Execution)
Когда по графу проходит импульс и достигает узла «Документ», узел действует как умный справочник.
Входящий текстовый сигнал (запрос от ИИ или другого узла) интерпретируется как Ключ для поиска нужного файла внутри этого узла.
То, что узел выдаст дальше по синапсам, строго зависит от его режима (_type):
Режим images
- Вход: Текстовый ключ (например, “схема_двигателя”).
- Действие: Узел ищет в своей памяти изображение с таким ключом (хранящееся в формате Base64), распаковывает его и создает временный физический файл на диске ПК/устройства.
- Выход: Узел формирует комплексное сообщение (_CompositeMessage) с вложенным файлом (тип arhive), готовое для передачи в модуль компьютерного зрения (Vision ИИ).
Режим documents
- Вход: Текстовый ключ (например, “инструкция_пк”).
- Действие: Узел ищет в своей памяти текст, сохраненный под этим ключом.
- Выход: Обычная текстовая строка (String) с полным содержимым документа. Идеально для подачи в контекст LLM (RAG).
Режим files
- Вход: Текстовый ключ (например, “лог_файл”).
- Действие: Узел находит сохраненный путь к файлу на жестком диске.
- Выход: Узел формирует комплексное сообщение (_CompositeMessage) с прикрепленным путем к файлу для дальнейшего анализа инструментами или агентами.
Режим document (или по умолчанию)
- Вход: Любой или отсутствует.
- Действие: Узел игнорирует входящий запрос.
- Выход: Узел просто возвращает текст, записанный в его свойстве _summary. Работает как жестко заданная константа или метка.
Пример сценария
- Агент ИИ отправляет узлу images запрос: “карта_полигона”.
- Узел находит эту картинку у себя, создает временный .png файл и передает его обратно Агенту.
Агент автоматически “видит” эту картинку и может её анализировать.