Все ноды/Data/DataFrame I/O

Конвертер

Универсальный конвертер payload: json ↔ dataframe ↔ csv. Выберите исходный и целевой тип.

Конвертер▶

ValueSuccess

Error

Тип в графе: convert

Exec

Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.

Порты можно разделить на исполнение и данные (split ports).

Как попробовать

Минимальный рабочий воркфлоу

Вход

Конвертер▶

Выход▶

Исполнение + данные

Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Запускается сразу

Как применять

Переводит значение между тремя формами: JSON (объект или список объектов), CSV-текст и таблица DataFrame. Чаще всего нода нужна на выходе из «табличного мира»: таблицу нельзя подставить в промпт, в тело HTTP-запроса или в Шаблон — сначала её надо превратить в JSON или CSV.

В обратную сторону конвертер требуется реже: ноды семейства DF и обе записи (CSV, XLSX) сами приводят к таблице список объектов и CSV-текст. Ставьте конвертер явно, когда нужно задать разбор — например разделитель ; или другую строку заголовка.

Как это работает

Пар конвертации четыре: JSON → DataFrame, DataFrame → JSON, DataFrame → CSV, CSV → DataFrame. Прямого пути между JSON и CSV нет: нужны две ноды подряд, через DataFrame. Проверка графа скажет об этом до запуска.

Поля меняются вместе с выбранной парой: «Разделитель CSV» появляется, когда CSV участвует в паре, «Включать заголовок CSV» — при выводе в CSV, «Строка заголовка CSV» — при чтении, «Макс. строк» — только при выводе в JSON.

Если «Из» и «В» совпадают, значение проходит насквозь без изменений.

Частые ошибки

«Из» не совпадает с тем, что пришло. Поле — это объявление, а не определение типа: нода не угадывает формат. Строка при «Из: JSON» даст ошибку вида «Cannot convert str to dataframe».
JSON → DataFrame из списка не-объектов. Ожидается список объектов (или один объект). Список чисел или строк таблицей не станет.
CSV → DataFrame с чужим разделителем. По умолчанию ,; выгрузка с ; превратится в одну колонку, а ошибки не будет.
DataFrame → JSON без «Макс. строк» перед моделью. В промпт уедет вся таблица, и она будет оплачена токенами. Ограничьте число строк или переведите в CSV — он заметно компактнее.

Входы

Порт	Провод	Данные	Примечания
Value`value`	Исполнение + данные`execute_data`	—

Выходы

Порт	Провод	Данные	Примечания
Success`output`	Исполнение + данные`execute_data`	—
Error`on_error`	Исполнение + данные`execute_data`	—	показывается, когда expose_error_output = true

Настройки

Поле	Тип	По умолчанию	Описание
Разделитель CSV`delimiter`	`string`	`,`
Из`from_kind`	`string`	`json`	Варианты: `json` — JSON, `csv` — CSV (текст), `dataframe` — DataFrame
Строка заголовка CSV`header_row`	`integer`	`0`	Индекс строки-заголовка при чтении CSV, 0 = первая строка (CSV → DataFrame). показывается при from_kind = csv
Включать заголовок CSV`include_header`	`boolean`	`true`	Писать строку заголовка при выводе CSV (DataFrame → CSV). показывается при to_kind = csv
Макс. строк (вывод json)`max_rows`	`integer`	`0`	Ограничить число строк при конвертации DataFrame → JSON (0 = без ограничения). показывается при to_kind = json
В`to_kind`	`string`	`dataframe`	Варианты: `json` — JSON, `csv` — CSV (текст), `dataframe` — DataFrame

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.
split_ports_in — Показывать отдельные порты входа для выполнения и данных вместо одного объединённого.
split_ports_out — Показывать отдельные порты выхода для выполнения и данных вместо одного объединённого.