Все ноды/Data/DataFrame Ops
Таблица: инструменты агента
Подключает к ИИ-агенту набор инструментов для работы с таблицами: загрузка CSV/XLSX, фильтрация, объединение, агрегация, сохранение. Файлы читает и пишет в хранилище пространства; порт «Хранилище файлов» нужен только для внешнего хранилища.
Тип в графе: dataframe_tool
Tool
Как попробовать
Минимальный рабочий сценарий
- Исполнение + данные
- Расширение
- LLM
- Память
- Исполнение + данные + стрим
Запускается сразу
Как применять
Даёт ИИ-агенту набор табличных инструментов: модель сама решает, какой файл открыть, чем отфильтровать, что с чем соединить и куда сохранить. Это ответ на просьбы вида «посмотри выгрузку и скажи, у кого просрочка» — заранее неизвестно, какие колонки понадобятся.
Если последовательность операций известна, собирайте её из нод df_*: они не тратят токены, не
зависят от догадливости модели и повторяются одинаково от запуска к запуску. Инструмент нужен
именно там, где шаги выбираются по ходу разговора.
Нода подключается связью link_extension в порт «Расширения агента» у агента и сама шагом графа не
является: вне агента она не работает.
Как это работает
Таблицы не ездят в переписке. Инструмент, создавший таблицу, кладёт её в память запуска и
возвращает модели короткий идентификатор (df_…) вместе с предпросмотром — схемой и несколькими
строками. Следующий вызов ссылается на этот идентификатор.
Идентификаторы живут в пределах одного хода агента: после того как агент ответил, память
очищается, и в следующем сообщении старый df_… уже не найдётся.
В списке «Разрешённые инструменты» доступны: загрузка CSV и XLSX, описание таблицы, фильтр строк, выбор колонок, соединение, группировка с агрегатами, выгрузка в JSON и сохранение в CSV или XLSX. Сортировки, обновления, склейки и удаления дубликатов среди инструментов нет — эти операции существуют только нодами.
Файлы читаются и пишутся через файловое хранилище. «Из текущего запуска» берёт хранилище
воркспейса, а «Подпапка» ограничивает его нужным каталогом (поле шаблонное, годится
sessions/{{ variables.session_id }}). «Внешнее подключение» открывает порт «Хранилище файлов» для
конфиг-ноды хранилища.
Частые ошибки
- Ожидание таблицы на выходе графа. У ноды нет выхода с данными. Наружу попадает только то, что модель включит в ответ, или файл, который она сохранит.
- Ссылка на идентификатор из прошлого сообщения. Инструмент ответит, что такой таблицы нет; файл придётся загрузить заново.
- Инструменты загрузки и сохранения без хранилища. Они вернут модели ошибку, остальные продолжат работать.
Входы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Хранилище файловfile_store | Данныеdata | — | показывается, когда connection_source ≠ "auto" |
Выходы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Расширение агентаtool_out | Расширениеlink_extension | — |
Настройки
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
Источник подключенияconnection_source | string | auto | Откуда нода берёт подключение. «Из текущего запуска» использует то, что платформа уже знает (Telegram-бот, на который опубликован сценарий / собственное файловое хранилище этого пространства), и связей не требует. «Внешнее подключение» показывает ресурсный порт, чтобы в него можно было подключить конфиг-ноду. Варианты: |
Подпапкаstore_subfolder | string | "" | Опциональная папка внутри хранилища этого пространства, которая используется как корень, например `reports` или `sessions/{{ variables.session_id }}`. Пусто = корень хранилища. поддерживает шаблоны показывается при «Источник подключения» = Из текущего запуска |
Разрешённые инструментыenabled_tools | array<string> | ["df_load_csv","df_load_xlsx","df_describe","df_query","df_select","df_merge"… | Какие инструменты DataFrame может вызывать агент. |