Все ноды/Integrations/Files
Инструмент файлов
Даёт ИИ-агенту файловые инструменты (fs_glob, fs_read, fs_write). По умолчанию работает с собственным хранилищем этого воркспейса; поставьте «Источник подключения» = «Внешнее подключение», чтобы указать на хранилище, подключённое к порту 'file_store'. По умолчанию только чтение — отметьте fs_write, чтобы разрешить модели создавать и перезаписывать файлы.
Тип в графе: file_tool
Tool
Как попробовать
Минимальный рабочий воркфлоу
- Исполнение + данные
- Расширение
- LLM
- Память
- Исполнение + данные + стрим
Запускается сразу
Как применять
Нода нужна, когда «какой файл открыть» решает модель, а не автор графа: разбор папки с отчётами, поиск нужной выгрузки по описанию, ведение заметок по ходу разговора. Если путь известен заранее, детерминированные Чтение файла, Запись файла и Поиск файлов дешевле и предсказуемее: их результат не зависит от того, как модель поняла задачу. Для табличной работы (загрузить CSV, отфильтровать, посчитать) есть отдельный Инструмент DataFrame.
Как это работает
Нода — не шаг сценария: у неё нет входа выполнения, она подключается проводом расширения в
порт extensions ноды ИИ-агент и добавляет модели до трёх
инструментов: fs_glob (список путей), fs_read (прочитать файл) и fs_write (создать или
перезаписать). По умолчанию включены только первые два — запись выдаётся галочкой осознанно.
Хранилище выбирается так же, как у обычных файловых нод: по умолчанию собственное хранилище
воркспейса, а в режиме «Внешнее подключение» — то, что подключено в порт file_store.
Ошибка инструмента возвращается модели — текстом с кодом, а не отказом ноды. Ход при этом
не прерывается: модель видит «файл не найден» и может попробовать другой путь. Бинарный файл,
прочитанный через fs_read, прикрепляется к диалогу вложением, и для этого нужно хранилище с
подключением — из встроенного хранилища воркспейса такой файл модели не показать.
Частые ошибки
fs_write«на всякий случай». С включённой галочкой модель может перезаписать любой файл в пределах корня, не спрашивая. Если запись нужна, ограничьте область полем «Подпапка».- Ожидание, что «Подпапка» ограничит внешний диск. Поле действует только в режиме «Из контекста рана»; у подключённой конфиг-ноды свой корень, и он шире.
- Расчёт на то, что выключенный инструмент недоступен «примерно». Он недоступен точно: вызов по угаданному имени отклоняется, а не выполняется.
- Один инструмент на несколько агентов. Инструменты видит только тот агент, в который проведён провод; второму агенту нужна своя нода.
- Ожидание exec-выхода. Его нет — ноду нельзя поставить в цепочку шагов.
Входы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
File storefile_store | Данныеdata | — | показывается, когда connection_source ≠ "auto" |
Выходы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
tool_out | Расширениеlink_extension | — |
Настройки
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
Включённые инструментыenabled_tools | array<string> | ["fs_glob","fs_read"] | Инструменты, которые агент может вызывать на подключённом хранилище. fs_write разрешает модели создавать и перезаписывать файлы — включайте осознанно. Имя инструмента, сохранённое старой версией и больше не существующее, остаётся в конфиге, но чекбокса для него нет. |
Источник подключенияconnection_source | string | auto | Откуда нода берёт подключение. «Из контекста рана» использует то, что платформа уже знает (Telegram-бот, в который задеплоен этот воркфлоу / собственное файловое хранилище этого воркспейса), и не требует проводов. «Внешнее подключение» показывает ресурсный порт, чтобы в него можно было подключить конфиг-ноду. Варианты: |
Подпапкаstore_subfolder | string | "" | Необязательная папка внутри хранилища этого воркспейса, которую считать корнем, напр. `reports` или `sessions/{{ variables.session_id }}`. Пусто = корень хранилища. поддерживает шаблоны показывается при connection_source = auto |